CryptGetDefaultOIDDllList 함수(wincrypt.h)

  • 아티클

CryptGetDefaultOIDDllList 함수는 지정된 함수 집합 및 인코딩 형식에 대해 등록된 OID(기본 개체 식별자) 함수가 포함된 DLL 파일의 이름 목록을 가져옵니다.

구문

BOOL CryptGetDefaultOIDDllList(
  [in]      HCRYPTOIDFUNCSET hFuncSet,
  [in]      DWORD            dwEncodingType,
  [out]     WCHAR            *pwszDllList,
  [in, out] DWORD            *pcchDllList
);

매개 변수

[in] hFuncSet

이전에 CryptInitOIDFunctionSet 호출로 얻은 함수 집합 핸들입니다.

[in] dwEncodingType

일치시킬 인코딩 형식을 지정합니다. 현재는 X509_ASN_ENCODING 및 PKCS_7_ASN_ENCODING만 사용되고 있습니다. 그러나 나중에 추가 인코딩 형식이 추가될 수 있습니다. 현재 인코딩 형식을 모두 일치하려면 다음을 사용합니다.

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

참고 인증서 또는 메시지 인코딩 유형 이 필요합니다. X509_ASN_ENCODING 기본값입니다. 해당 형식이 표시되면 이 형식이 사용됩니다. 그렇지 않으면 PKCS7_ASN_ENCODING 형식이 표시되면 이 형식이 사용됩니다.
 

[out] pwszDllList

0개 이상의 null로 종료된 파일 이름 목록을 수신하는 버퍼에 대한 포인터입니다. 반환된 목록은 종료되는 NULL 문자로 종료됩니다. 예를 들어 두 이름의 목록은 다음과 같습니다.

L"first.dll\0" L"second.dll\0" L"\0"

버퍼가 보유해야 하는 와이드 문자 수를 검색하려면 이 매개 변수가 NULL일 수 있습니다. 자세한 내용은 알 수 없는 길이의 데이터 검색을 참조하세요.

[in, out] pcchDllList

pwszDllList 매개 변수가 가리키는 반환된 목록의 크기를 와이드 문자로 지정하는 DWORD에 대한 포인터입니다. 함수가 반환되면 pcchDllList 매개 변수가 가리키는 변수에는 버퍼에 저장된 와이드 문자 수가 포함됩니다.

참고 버퍼에서 반환된 데이터를 처리할 때 애플리케이션은 반환된 데이터의 실제 크기를 사용해야 합니다. 실제 크기는 입력에 지정된 버퍼 크기보다 약간 작을 수 있습니다. 입력에서 버퍼 크기는 일반적으로 가능한 가장 큰 출력 데이터가 버퍼에 맞도록 충분히 크게 지정됩니다. 출력 시 이 매개 변수가 가리키는 변수는 버퍼에 복사된 데이터의 실제 크기를 반영하도록 업데이트됩니다.
 

반환 값

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

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

이 함수에는 다음과 같은 오류 코드가 있습니다.

반환 코드 설명
ERROR_MORE_DATA
 pwszDllList 매개 변수로 지정된 버퍼가 반환된 데이터를 저장할 만큼 크지 않은 경우 함수는 ERROR_MORE_DATA 코드를 설정하고 필요한 버퍼 크기를 pcchDllList가 가리키는 변수에 와이드 문자로 저장합니다.

요구 사항

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

추가 정보

OID 지원 함수