CryptGetDefaultOIDFunctionAddress 함수(wincrypt.h)
CryptGetDefaultOIDFunctionAddress 함수는 기본 함수 주소를 포함하는 DLL을 로드합니다. 또한 초기화된 함수 집합에서 첫 번째 또는 다음에 설치된 OID(기본 개체 식별자 ) 함수의 주소를 반환하고 해당 함수의 주소를 포함하는 DLL을 로드할 수도 있습니다.
구문
BOOL CryptGetDefaultOIDFunctionAddress(
[in] HCRYPTOIDFUNCSET hFuncSet,
[in] DWORD dwEncodingType,
[in, optional] LPCWSTR pwszDll,
[in] DWORD dwFlags,
[out] void **ppvFuncAddr,
[in, out] HCRYPTOIDFUNCADDR *phFuncAddr
);
매개 변수
[in] hFuncSet
이전에 CryptInitOIDFunctionSet 호출에서 가져온 함수 집합 핸들입니다.
[in] dwEncodingType
일치시킬 인코딩 형식입니다. 현재는 X509_ASN_ENCODING 및 PKCS_7_ASN_ENCODING만 사용되고 있습니다. 그러나 나중에 추가 인코딩 형식이 추가될 수 있습니다. 현재 인코딩 형식을 모두 일치하려면 다음을 사용합니다.
X509_ASN_ENCODING | PKCS_7_ASN_ENCODING
[in, optional] pwszDll
로드할 DLL의 이름입니다. 일반적으로 DLL 이름은 CryptGetDefaultOIDDllList에서 반환된 목록에서 가져옵니다. pwszDll이 NULL이면 설치된 기본 함수 목록에서 검색이 수행됩니다.
[in] dwFlags
나중에 사용할 수 있으며 0이어야 합니다.
[out] ppvFuncAddr
반환 함수의 주소에 대한 포인터입니다. 함수가 실패하면 ppvFuncAddr에서 NULL이 반환됩니다.
[in, out] phFuncAddr
pwszDll이NULL인 경우에만 사용됩니다. 함수에 대한 첫 번째 호출에서 *phFuncAddr 는 처음 설치된 함수를 획득하려면 NULL 이어야 합니다.
이 함수가 성공하면 *phFuncAddr 가 함수 핸들로 설정됩니다. 함수 핸들에 대한 참조 수가 증가합니다.
함수에 대한 첫 번째 호출 후 phFuncAddr 는 이전 호출에서 반환된 포인터로 설정됩니다. 이 입력 포인터는 이 함수에 의한 CryptFreeOIDFunctionAddress 호출을 통해 함수 내에서 항상 해제됩니다. 포인터를 해제하기 위한 호출은 기본 함수가 오류를 반환하는 경우에도 항상 이루어집니다.
NULL이 아닌 phFuncAddr는 CryptFreeOIDFunctionAddress 호출을 통해 또는 이 함수에 대한 입력 또는 CryptGetOIDFunctionAddress에 대한 입력으로 다시 전달되어야 합니다.
pwszDll이 NULL이 아니면 이 매개 변수의 값이 무시되고 NULL이 아닌 포인터가 해제되지 않습니다.
반환 값
함수가 성공하면 함수는 0이 아닌 값(TRUE)을 반환합니다.
함수가 실패하면 0(FALSE)을 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | wincrypt.h |
| 라이브러리 | Crypt32.lib |
| DLL | Crypt32.dll |