IAlternativeName::InitializeFromOtherName 메서드(certenroll.h)

InitializeFromOtherName 메서드는 OID(개체 식별자) 및 연결된 원시 데이터(바이트 배열)에서 개체를 초기화합니다. 이 메서드는 추상 구문 표기법 1(ASN.1) AlternativeNames 확장 선언에서 otherName 필드를 지원하기 위해 제공됩니다.

----------------------------------------------------------------------
-- AlternativeNames 
-- XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17)
----------------------------------------------------------------------

AltNames ::= SEQUENCE --#public-- OF GeneralName
GeneralNames ::= AltNames

GeneralName ::= CHOICE 
{
   otherName               [0] IMPLICIT OtherName,
   rfc822Name              [1] IMPLICIT IA5STRING,
   dNSName                 [2] IMPLICIT IA5STRING,
   x400Address             [3] IMPLICIT SeqOfAny,       -- Not supported
   directoryName           [4] EXPLICIT ANY,    
   ediPartyName            [5] IMPLICIT SeqOfAny,
   uniformResourceLocator  [6] IMPLICIT IA5STRING,
   iPAddress               [7] IMPLICIT OCTETSTRING,
   registeredID            [8] IMPLICIT EncodedObjectID -- Not supported
}

OtherName ::= SEQUENCE 
{
   type                    EncodedObjectID,
   value                   [0] EXPLICIT NOCOPYANY 
}

구문

HRESULT InitializeFromOtherName(
  [in] IObjectId    *pObjectId,
  [in] EncodingType Encoding,
  [in] BSTR         strRawData,
  [in] VARIANT_BOOL ToBeWrapped
);

매개 변수

[in] pObjectId

OID를 나타내는 IObjectId 인터페이스에 대한 포인터입니다.

[in] Encoding

strRawData 매개 변수에 적용된 유니코드 인코딩의 형식을 식별하는 EncodingType 열거형 값입니다.

[in] strRawData

OID와 연결된 이름을 포함하는 BSTR 변수입니다.

[in] ToBeWrapped

strRawData 매개 변수에 포함된 입력 문자열이 인코딩되어 옥텟 문자열(바이트 배열)로 저장되는지 여부를 식별하는 VARIANT_BOOL 변수입니다.

반환 값

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

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

반환 코드/값	설명
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	개체가 이미 초기화되어 있습니다.

설명

이 함수를 사용하여 OID 및 연결된 문자열 값에서 IAlternativeName 개체를 초기화할 수 있습니다. 문자열은 유니코드로 인코딩됩니다. ToBeWrapped 매개 변수에 true를 지정하면 문자열은 DER(Distinguished Encoding Rules)를 사용하여 인코딩됩니다. ObjectId 속성을 호출하여 OID를 검색할 수 있습니다. 인코딩된 문자열을 검색하거나 ToBeWrapped 가 true이면 RawData 속성을 호출하여 인코딩된 바이트 배열을 검색하여 DER로 인코딩된 바이트 배열을 검색할 수 있습니다.

요구 사항

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

추가 정보

IAlternativeName