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

추가 정보

OID 지원 함수