PFXVerifyPassword 함수(wincrypt.h)

PFXVerifyPassword 함수는 BLOB의 외부 계층을 PFX(개인 정보 교환) 패킷으로 디코딩하고 지정된 암호로 암호를 해독하려고 시도합니다. BLOB에서 데이터를 가져오지 않습니다.

PFX 형식을 Public-Key 암호화 표준 #12(PKCS #12) 형식이라고도 합니다.

구문

BOOL PFXVerifyPassword(
  [in] CRYPT_DATA_BLOB *pPFX,
  [in] LPCWSTR         szPassword,
  [in] DWORD           dwFlags
);

매개 변수

[in] pPFX

함수가 PFX 패킷으로 디코딩하려고 시도하는 CRYPT_DATA_BLOB 구조체에 대한 포인터입니다.

[in] szPassword

확인할 문자열 암호입니다. 이 함수가 성공하려면 이 암호가 패킷을 암호화하는 데 사용되는 암호와 정확히 동일해야 합니다.

이 값을 빈 문자열 또는 NULL로 설정하는 경우 이 함수는 일반적으로 빈 문자열 또는 NULL을 사용하여 PFX BLOB에 포함된 암호를 해독하려고 시도합니다.

그러나 Windows 8 및 Windows Server 2012 시작하여 PFX BLOB을 만들 때 NULL 또는 빈 암호를 지정하고 애플리케이션이 암호를 AD(Active Directory) 보안 주체로 보호하도록 지정한 경우 CAPI(Cryptography API)는 임의로 암호를 생성하고 AD 보안 주체에 암호화하고 PFX BLOB에 포함합니다. PFXVerifyPassword 함수는 지정된 AD 보안 주체(현재 사용자, 컴퓨터 또는 AD 그룹 구성원)를 사용하여 암호 해독을 시도합니다. PFX를 AD 보안 주체로 보호하는 방법에 대한 자세한 내용은 PFXExportCertStoreEx 함수의 pvPara 매개 변수 및 PKCS12_PROTECT_TO_DOMAIN_SIDS 플래그를 참조하세요.

암호 사용을 마쳤으면 SecureZeroMemory 함수를 호출하여 메모리에서 암호를 지웁 암호 보호에 대한 자세한 내용은 암호 처리를 참조하세요.

[in] dwFlags

다음에 사용하도록 예약됩니다.

반환 값

암호가 올바르게 표시되면 함수는 TRUE 를 반환합니다. 그렇지 않으면 FALSE를 반환 합니다.

요구 사항

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