CertGetNameString 函数解析与例子.docxVIP

CertGetNameString function1 out of 2 rated this helpful - Rate this topicThe CertGetNameString function obtains the subject or issuer name from a certificate CERT_CONTEXT structure and converts it to a null-terminated character string.SyntaxC++DWORD WINAPI CertGetNameString( _In_ PCCERT_CONTEXT pCertContext, _In_ DWORD dwType, _In_ DWORD dwFlags, _In_ void *pvTypePara, _Out_ LPTSTR pszNameString, _In_ DWORD cchNameString);ParameterspCertContext [in]A pointer to a CERT_CONTEXT certificate context that includes a subject and issuer name to be converted.dwType [in]DWORD indicating how the name is to be found and how the output is to be formatted.ValueMeaningCERT_NAME_EMAIL_TYPE1If the certificate has a Subject Alternative Name extension or Issuer Alternative Name, uses the first rfc822Name choice. If no rfc822Name choice is found in the extension, uses the Subject Name field for the Email OID. If either rfc822Name or the Email OID is found, uses the string. Otherwise, returns an empty string (returned character count is 1). pvTypePara is not used and is set to NULL.CERT_NAME_RDN_TYPE2Converts the Subject Name BLOB by calling CertNameToStr. pvTypePara points to a DWORD containing the dwStrType passed to CertNameToStr. If the Subject Name field is empty and the certificate has a Subject Alternative Name extension, uses the first directory Name choice from CertNameToStr.CERT_NAME_ATTR_TYPE3pvTypePara points to an object identifier (OID) specifying the name attribute to be returned. For example, if pvTypePara is szOID_COMMON_NAME, uses the Subject Name member. If the Subject Name member is empty and the certificate has a Subject Alternative Name extension, uses the first directoryName choice.CERT_NAME_SIMPLE_DISPLAY_TYPE4Iterates through the following list of name attributes and uses the Subject Name or the Subject Alternative Name extension for the first occurrence of: szOID_COMMON_NAME, szOID_ORGANIZATIONAL_UNIT_NAME, szOID_ORGANIZATION_NAME, or szOID_RS