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로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

이 함수는 특성 정보를 포함하는 CRYPTCATATTRIBUTE 구조체에 대한 포인터를 반환합니다. 이 함수가 실패하면 NULL을 반환합니다.

중요 반환된 포인터나 반환된 포인터가 가리키는 멤버를 해제하지 마세요.

이 함수가 NULL을 반환하는 경우 GetLastError 함수를 호출하여 추가 오류 정보를 가져올 수 있습니다. GetLastError 는 다음 오류 코드 중 하나를 반환합니다.

반환 코드	설명
CRYPT_E_NOT_FOUND	멤버 또는 특성을 찾을 수 없습니다.
ERROR_INVALID_PARAMETER	하나 이상의 매개 변수가 잘못되었습니다.