[New - Windows NT]
WinTrustSubjectGetName函数从表示主题的PKCS＃7签名数据证书中检索主题的名称。信任提供者可以使用该名称来存储和检索与该主题相关联的证书。
BOOL WinTrustSubjectGetName(
| LPWIN_TRUST_SIP_SUBJECT 【lpSubject】, | //指向主题描述的指针 |
| LPWIN_CERTIFICATE 【lpSignedData】, | //指向已签名数据证书的指针 |
| LPWSTR 【lpBuffer】, | //指向接收主题名称的缓冲区的指针 |
| LPDWORD 【lpRequiredLength】 | //指向缓冲区的大小（以字节为单位）的指针 |
| ); |
参数
【lpSubject】
指向WIN_TRUST_SIP_SUBJECT结构的指针，用于标识主题的类型。请注意，该函数从【lpSignedData】结构中检索主题的名称，而不是主题。
【lpSignedData】
指向包含PKCS＃7签名数据结构的WIN_CERTIFICATE结构。该函数从与此结构相关联的数据中检索主题名称。
【lpBuffer】
指向缓冲区的指针，该缓冲区接收以空值终止的Unicode字符串，命名主题。
【lpRequiredLength】
指向DWORD.在输入时，它指定【lpBuffer】缓冲区的大小（以字节为单位）。在输出时，它接收返回字符串的大小（以字节为单位），包括终止空字符。如果缓冲区不够大以容纳字符串，则该函数失败，【lpRequiredLength】返回所需的缓冲区大小。
返回值
如果函数成功，则返回值为非零值。
如果函数失败，返回值为零。要获取扩展错误信息，请调用GetLastError.
备注
信任提供者调用了WinTrustSubjectGetName函数的WinTrust实现。WinTrust然后调用WinTrustSubjectGetName相应主题界面包（SIP）的实现。适当的SIP是为了处理由【lpSubject】参数指定的主题类型而注册的SIP。
每个主题界面包（SIP）DLL都必须实现WinTrustSubjectGetName功能。当WinTrust调用SIP的WinTrustSipInitialize初始化功能时，WinTrust将获得指向SIP的WinTrustSubjectGetName实现的指针。
SIP的WinTrustSubjectGetName的实现返回与主题相关联的名称。这可能是一个文件名，如果主题是一个文件，或者一些标识主题的其他字符串。此函数的目的是提供信任提供者可用于存储和检索与主题相关联的证书的字符串。该名称不需要是唯一的，但它应该标识主题，并在每次检索时都相同。
LPWINTRUST_SUBJECT_GET_NAME类型是指向WinTrustSubjectGetName函数的指针。
也可以看看
WIN_CERTIFICATE, WIN_TRUST_SIP_SUBJECT, WinTrustSipInitialize
