다음을 통해 공유

ICspInformation::GetCspStatusFromOperations 메서드(certenroll.h)

  • 아티클

GetCspStatusFromOperations 메서드는 지정된 서명, 암호화, 해시 또는 암호 작업과 일치하는 지원되는 첫 번째 알고리즘에 대한 ICspStatus 개체를 만듭니다.

구문

HRESULT GetCspStatusFromOperations(
  [in, optional] IObjectId               *pAlgorithm,
  [in]           AlgorithmOperationFlags Operations,
  [out]          ICspStatus              **ppValue
);

매개 변수

[in, optional] pAlgorithm

알고리즘 OID를 나타내는 IObjectId 인터페이스에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

  • OID를 지정하고 Operations 매개 변수를 XCN_NCRYPT_SIGNATURE_OPERATION 설정하고 이 플래그를 XCN_NCRYPT_EXACT_MATCH_OPERATION 또는 XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION 결합하면 OID와 일치하는 첫 번째 서명 알고리즘(있는 경우)이 사용됩니다.
  • OID를 지정하지만 Operations 매개 변수를 XCN_NCRYPT_SIGNATURE_OPERATION 설정하지 않거나 XCN_NCRYPT_SIGNATURE_OPERATION 설정하지만 XCN_NCRYPT_EXACT_MATCH_OPERATION 또는 XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION 결합하지 않으면 서명 또는 암호화에 사용할 수 있는 첫 번째 알고리즘이 사용됩니다.
  • OID를 지정하지 않으면 Operations 매개 변수에 지정된 플래그와 일치하는 첫 번째 지원 알고리즘이 사용됩니다.

[in] Operations

검색할 알고리즘의 유형을 식별하는 AlgorithmOperationFlags 열거형 값입니다. 다음 값 중 하나를 지정해야 합니다.

  • XCN_NCRYPT_CIPHER_OPERATION
  • XCN_NCRYPT_HASH_OPERATION
  • XCN_NCRYPT_SIGNATURE_OPERATION
  • XCN_NCRYPT_SECRET_AGREEMENT_OPERATION
  • XCN_NCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION

위의 플래그 중 하나를 다음 중 하나와 결합하여 검색 특성을 구체화할 수 있습니다.

  • XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION
  • XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION
  • XCN_NCRYPT_EXACT_MATCH_OPERATION

XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION 또는 XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION 기본 설정 플래그를 설정하는 경우 다음 중 하나를 지정할 수도 없습니다.

  • XCN_NCRYPT_CIPHER_OPERATION
  • XCN_NCRYPT_HASH_OPERATION

[out] ppValue

ICspStatus 인터페이스에 대한 포인터를 수신하는 변수의 주소입니다.

반환 값

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

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

반환 코드/값 설명
CERTSRV_E_PROPERTY_EMPTY
 ICspStatus 개체를 찾을 수 없습니다.
OLE_E_BLANK
 ICspInformation 개체가 초기화되지 않았습니다.

설명

ICspStatus 개체에는 암호화 공급자에 대한 상태 정보가 포함됩니다. 각 개체는 공급자가 지원하는 특정 알고리즘에 대해 초기화됩니다. pAlgorithm 매개 변수에서 알고리즘을 지정하지 않으면 허용되는 작업과 일치하는 첫 번째 지원되는 알고리즘이 ICspStatus 개체를 만들기 위해 선택됩니다.

요구 사항

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

추가 정보

ICspInformation