다음을 통해 공유

IObjectId::GetAlgorithmName 메서드(certenroll.h)

  • 아티클

GetAlgorithmName 메서드는 알고리즘 OID(개체 식별자)와 연결된 표시 이름을 검색합니다.

구문

HRESULT GetAlgorithmName(
  [in]  ObjectIdGroupId        GroupId,
  [in]  ObjectIdPublicKeyFlags KeyFlags,
  [out] BSTR                   *pstrAlgorithmName
);

매개 변수

[in] GroupId

검색할 OID 그룹을 지정하는 ObjectIdGroupId 열거형 값입니다. 다음 알고리즘 그룹 중 어느 것일 수 있습니다.

  • XCN_CRYPT_HASH_ALG_OID_GROUP_ID
  • XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID
  • XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID
  • XCN_CRYPT_SIGN_ALG_OID_GROUP_ID
또한 암호화 알고리즘을 포함하지 않는 그룹을 지정할 수도 있습니다.
  • XCN_CRYPT_RDN_ATTR_OID_GROUP_ID
  • XCN_CRYPT_EXT_OR_ATTR_OID_GROUP_ID
  • XCN_CRYPT_ENHKEY_USAGE_OID_GROUP_ID
  • XCN_CRYPT_POLICY_OID_GROUP_ID
  • XCN_CRYPT_TEMPLATE_OID_GROUP_ID

[in] KeyFlags

서명 또는 암호화 알고리즘을 검색할지 여부를 지정하는 ObjectIdPublicKeyFlags 열거형 값입니다. 다음 값 중 하나일 수 있습니다.

  • XCN_CRYPT_OID_INFO_PUBKEY_ANY
  • XCN_CRYPT_OID_INFO_PUBKEY_SIGN_KEY_FLAG
  • XCN_CRYPT_OID_INFO_PUBKEY_ENCRYPT_KEY_FLAG
마지막 두 값 중 하나를 사용하여 메시지를 암호화하고 서명하는 데 사용할 수 있는 RSA와 같은 알고리즘을 구분할 수 있습니다. GroupId 매개 변수에 XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID 지정해야 합니다. GroupId 매개 변수를 XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID 이외의 항목으로 설정하면 XCN_CRYPT_OID_INFO_PUBKEY_ANY 지정합니다.

[out] pstrAlgorithmName

이름을 포함하는 BSTR 변수에 대한 포인터입니다.

반환 값

함수가 성공하면 함수는 S_OK 반환합니다.

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

반환 코드/값 설명
CERTSRV_E_PROPERTY_EMPTY
 알고리즘 이름을 포함하는 문자열이 비어 있습니다.
OLE_E_BLANK
 알고리즘 이름을 찾을 수 없습니다. GetAlgorithmName을 호출하기 전에 InitializeFromAlgorithmName을 호출해야 합니다.

설명

XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID 상수를 사용하여 가변 비트 길이로 식별할 수 있는 알고리즘의 키 크기를 고려한 GroupId 매개 변수 값을 만들 수 있습니다. 예를 들어 192비트 AES 알고리즘에서 IObjectId 개체를 초기화하려면 strAlgorithmName 매개 변수에 "AES"를 지정하고, 길이를 왼쪽으로 16으로 이동하고, 이동된 비트 길이 및 XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID 비트 OR 조합을 수행합니다.

GroupId 매개 변수를 XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID 이외의 항목으로 설정하는 경우 KeyFlags 매개 변수에 대한 XCN_CRYPT_OID_INFO_PUBKEY_ANY 지정합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 certenroll.h
DLL CertEnroll.dll

추가 정보

IObjectId