Share via

CryptEnumKeyIdentifierProperties 함수(wincrypt.h)

  • 아티클
중요 이 API는 더 이상 사용되지 않습니다. 신규 및 기존 소프트웨어는 암호화 차세대 API 사용을 시작해야 합니다. Microsoft는 이후 릴리스에서 이 API를 제거할 수 있습니다.
 
CryptEnumKeyIdentifierProperties 함수는 키 식별자와 해당 속성을 열거합니다. 이 함수는 루프에서 호출되지 않습니다. 대신 마지막 키 식별자 속성이 열거되거나 콜백 함수가 FALSE를 반환할 때까지 내부적으로 반복됩니다. dwPropId가 0이거나 키 식별자의 속성이 dwPropId와 일치하는 경우 콜백 함수가 호출됩니다.

구문

BOOL CryptEnumKeyIdentifierProperties(
  [in, optional] const CRYPT_HASH_BLOB     *pKeyIdentifier,
  [in]           DWORD                     dwPropId,
  [in]           DWORD                     dwFlags,
  [in, optional] LPCWSTR                   pwszComputerName,
  [in]           void                      *pvReserved,
  [in, optional] void                      *pvArg,
  [in]           PFN_CRYPT_ENUM_KEYID_PROP pfnEnum
);

매개 변수

[in, optional] pKeyIdentifier

키 식별자를 포함하는 CRYPT_HASH_BLOB 구조체에 대한 포인터입니다.

pKeyIdentifier가 NULL이면 함수는 모든 키 식별자를 열거합니다.

pKeyIdentifier가 NULL이 아닌 경우 지정된 키 식별자에 대해서만 콜백 함수 pfnEnum이 호출됩니다.

[in] dwPropId

나열할 속성 식별자를 나타냅니다.

dwPropId가 0으로 설정된 경우 이 함수는 모든 속성을 사용하여 콜백 함수를 호출합니다.

dwPropId가 0이 아니고 pKeyIdentifier가 NULL이면 지정된 속성이 있는 키 식별자에 대해서만 콜백 함수가 호출됩니다(pfnEnum의 cProp 매개 변수를 1로 설정). 속성이 없는 모든 키 식별자는 건너뜁니다.

모든 인증서 속성 식별자를 사용할 수 있습니다.

[in] dwFlags

기본적으로 CurrentUser의 키 식별자 목록이 검색됩니다. CRYPT_KEYID_MACHINE_FLAG 설정된 경우 LocalMachine( pwszComputerName 이 NULL인 경우) 또는 원격 컴퓨터( pwszComputerName 이 NULL이 아닌 경우)의 키 식별자 목록이 검색됩니다. 자세한 내용은 pwszComputerName을 참조하세요.

[in, optional] pwszComputerName

검색할 원격 컴퓨터의 이름에 대한 포인터입니다. CRYPT_KEYID_MACHINE_FLAG dwFlags에 설정된 경우 원격 컴퓨터에서 키 식별자 목록을 검색합니다. 원격 컴퓨터가 아닌 로컬 컴퓨터를 검색하려면 pwszComputerName 이 NULL로 설정됩니다.

[in] pvReserved

나중에 사용할 수 있으며 NULL이어야 합니다.

[in, optional] pvArg

콜백 함수에 전달할 데이터에 대한 포인터입니다. 형식은 애플리케이션이 모든 정보를 보유하도록 구조체 또는 인수를 선언, 정의 및 초기화할 수 있는 void입니다.

[in] pfnEnum

입력 매개 변수와 일치하는 각 키 식별자 항목에 대해 실행되는 애플리케이션 정의 콜백 함수에 대한 포인터입니다. 콜백 함수 매개 변수에 대한 자세한 내용은 CRYPT_ENUM_KEYID_PROP 참조하세요.

반환 값

CryptEnumKeyIdentifierProperties 함수는 마지막 키 식별자가 열거되거나 콜백 함수가 FALSE를 반환할 때까지 CRYPT_ENUM_KEYID_PROP 콜백 함수를 반복적으로 호출합니다.

기본 함수가 성공하면 함수는 0이 아닌 값(TRUE)을 반환합니다.

함수가 실패하면 0(FALSE)을 반환합니다. 확장된 오류 정보는 GetLastError를 호출합니다.

열거를 계속하기 위해 함수는 TRUE를 반환 합니다.

열거를 중지하기 위해 함수는 FALSE 를 반환하고 마지막 오류 코드를 설정합니다.

설명

키 식별자는 인증서 컨텍스트와 동일한 속성을 가질 수 있습니다.

예제

이 함수를 사용하는 예제는 예제 C 프로그램: 키 식별자 작업을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 wincrypt.h
라이브러리 Crypt32.lib
DLL Crypt32.dll

추가 정보

기본 암호화 함수

CryptGetKeyIdentifierProperty

CryptSetKeyIdentifierProperty