Share via

IX509AttributeClientId::InitializeEncode 메서드(certenroll.h)

  • 아티클

InitializeEncode 메서드는 인증서 요청을 제출한 사용자, 클라이언트 컴퓨터 및 애플리케이션에 대한 정보에서 특성을 초기화합니다.

구문

HRESULT InitializeEncode(
  [in]           RequestClientInfoClientId ClientId,
  [in, optional] BSTR                      strMachineDnsName,
  [in, optional] BSTR                      strUserSamName,
  [in, optional] BSTR                      strProcessName
);

매개 변수

[in] ClientId

요청을 만든 애플리케이션의 유형을 식별하는 RequestClientInfoClientId 열거형 값입니다. 예를 들어 자동 등록 서비스, 명령줄 요청 도구 및 사용자 지정 요청 애플리케이션이 있습니다.

[in, optional] strMachineDnsName

요청이 만들어진 컴퓨터의 DNS(Domain Name System) 이름을 포함하는 BSTR 변수입니다(예: ComputerName.contoso.com). 이름을 제공하지 않으면 메서드는 GetComputerNameEx 함수를 호출합니다. 이름을 찾을 수 없으면 메서드가 실패합니다.

[in, optional] strUserSamName

DomainName\UserName 형식의 사용자에 대한 SAM(보안 계정 관리자) 이름을 포함하는 BSTR 변수입니다. 이름을 제공하지 않으면 메서드는 GetUserNameEx 함수를 호출합니다. 이름을 찾을 수 없으면 메서드가 실패합니다.

[in, optional] strProcessName

인증서 요청을 만든 애플리케이션의 이름을 포함하는 BSTR 변수입니다. 이름을 제공하지 않으면 메서드는 GetCommandLine 함수를 호출하고 명령줄을 구문 분석합니다. 이름을 찾을 수 없으면 메서드가 실패합니다.

반환 값

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

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 일반적인 오류 코드 목록은 일반 HRESULT 값을 참조하세요.

설명

이 특성의 개체 식별자 (OID)는 XCN_OID_REQUEST_CLIENT_INFO (1.3.6.1.4.1.311.21.20)입니다. 자세한 내용은 CERTENROLL_OBJECTID. 특성은 DER(Distinguished Encoding Rules)을 사용하여 인코딩되는 ASN.1(Abstract Syntax Notation One) 구조체로 만들어집니다.

IX509AttributeClientId 개체를 사용하려면 먼저 InitializeEncode 또는 InitializeDecode를 호출해야 합니다. 두 메서드는 서로를 보완합니다. InitializeEncode 메서드를 사용하면 원시 데이터에서 인코딩된 ASN.1 구조를 생성할 수 있으며 InitializeDecode 메서드를 사용하면 인코딩된 ASN.1 구조체에서 원시 데이터를 초기화할 수 있습니다. 다음 속성을 호출하여 원시 데이터를 검색할 수 있습니다.

요구 사항

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

추가 정보

IX509AttributeClientId

InitializeDecode