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 |