CryptRegisterOIDInfo 함수(wincrypt.h)

아티클
08/27/2023

CryptRegisterOIDInfo 함수는 CRYPT_OID_INFO 구조에 지정된 OID 정보를 등록하여 레지스트리에 유지합니다.

Crypt32.dll 일반적으로 알려진 OID에 대해 미리 정의된 정보를 포함합니다. 이 함수를 사용하면 애플리케이션이 미리 정의된 OID 정보를 보강할 수 있습니다. CryptRegisterOIDInfo의 첫 번째 호출 중에 등록된 OID 정보가 설치됩니다.

CryptRegisterOIDInfo를 사용하여 테이블을 확장할 때 dwFlags로 제어되는 미리 정의된 항목 앞이나 후에 새 항목을 배치할 수 있습니다. 등록된 OID 정보의 배치는 테이블이 순서대로 검색되기 때문에 CryptFindOIDInfo 의 결과에 영향을 줍니다. 미리 정의된 항목이 선택되기 전에 먼저 등록된 항목이 선택된 다음 미리 정의된 항목이 선택되고 마지막으로 미리 정의된 항목이 확인된 후에 등록된 항목이 배치됩니다. 찾은 첫 번째 일치 항목이 반환됩니다. 미리 정의된 항목 앞에 새로 등록된 항목이 미리 정의된 항목 중 하나를 재정의할 수 있습니다.

구문

BOOL CryptRegisterOIDInfo(
  [in] PCCRYPT_OID_INFO pInfo,
  [in] DWORD            dwFlags
);

매개 변수

[in] pInfo

등록할 OID 정보가 있는 CRYPT_OID_INFO 구조체에 대한 포인터입니다. 구조체의 dwGroupId 멤버를 설정하여 OID 정보를 등록할 그룹을 지정합니다.

참고

Cryptography API: Next Generation(CNG)으로 구현된 Suite B 알고리즘에 대한 OID 정보를 등록하는 경우 CRYPT_OID_INFO 구조체의 Algid 멤버를 CALG_OID_INFO_CNG_ONLY(0xFFFFFFFF)로 설정해야 합니다.

[in] dwFlags

기본적으로 등록된 OID 정보는 Crypt32.dll OID 항목 후에 설치됩니다. CRYPT_INSTALL_OID_INFO_BEFORE_FLAG 설정되면 Crypt32.dll 항목 앞에 새 OID 정보가 설치됩니다.

반환 값

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

함수가 실패하면 반환 값은 0(FALSE)입니다.

설명

OID 정보 사용을 마쳤으면 CryptUnregisterOIDInfo 함수를 호출하여 등록을 취소합니다.

요구 사항

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