CryptCATGetAttrInfo 函式 (mscat.h)

[ CryptCATGetAttrInfo 函式可用於需求一節中指定的作業系統。後續版本可能會變更或無法使用。]

CryptCATGetAttrInfo函式會擷取目錄成員屬性的相關資訊。

語法

CRYPTCATATTRIBUTE * CryptCATGetAttrInfo(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pCatMember,
  [in] LPWSTR         pwszReferenceTag
);

[in] hCatalog

包含要擷取屬性資訊之成員之目錄的控制碼。呼叫 CryptCATOpen 函式可取得此控制碼。這個參數是必要的，而且不能是 Null。

[in] pCatMember

CRYPTCATMEMBER結構的指標，表示要擷取屬性資訊的成員。呼叫 CryptCATGetMemberInfo 函式即可取得此專案。這個參數是必要的，而且不能是 Null。

[in] pwszReferenceTag

Null 終止 Unicode 字串的指標，其中包含要擷取資訊的屬性名稱。這個參數是必要的，而且不能是 Null。

此函式會傳回 CRYPTCATATTRIBUTE 結構的指標，其中包含屬性資訊。如果函式失敗，則會傳回 Null。

重要請勿釋放傳回的指標，也不會釋放傳回指標所指向的任何成員。

如果此函式傳回 Null，則可以呼叫 GetLastError 函式來取得其他錯誤資訊。 GetLastError 會傳回下列其中一個錯誤碼。

傳回碼	描述
CRYPT_E_NOT_FOUND	找不到成員或屬性。
ERROR_INVALID_PARAMETER	一或多個參數無效。