ICLRAssemblyIdentityManager::GetBindingIdentityFromFile 메서드

아티클
08/09/2011

지정된 파일 경로에 있는 어셈블리의 어셈블리 ID 바인딩 데이터를 가져옵니다.

HRESULT GetBindingIdentityFromFile(
    [in] LPCWSTR     pwzFilePath,
    [in] DWORD       dwFlags,
    [out, size_is(*pcchBufferSize)] LPWSTR pwzBuffer,
    [in, out] DWORD *pcchBufferSize
);

매개 변수

pwzFilePath
[in] 확인할 파일의 경로입니다.
dwFlags
[in] 어셈블리의 ID 형식을 나타내는 ECLRAssemblyIdentityFlags 열거형의 값입니다. 앞으로의 확장 가능성을 고려하여 제공됩니다. CLR(공용 언어 런타임) 버전 2.0에서는 CLR_ASSEMBLY_IDENTITY_FLAGS_DEFAULT 값만 지원됩니다.
pwzBuffer
[out] 불투명 어셈블리 ID 데이터를 포함하는 버퍼입니다.
pcchBufferSize
[in, out] pwzBuffer의 크기에 대한 포인터입니다.

반환 값

HRESULT	설명
S_OK	메서드가 성공적으로 반환했습니다.
E_INVALIDARG	제공된 pwzFilePath가 null입니다.
ERROR_INSUFFICIENT_BUFFER	pwzBuffer의 크기가 너무 작습니다.
HOST_E_CLRNOTAVAILABLE	CLR이 프로세스에 로드되지 않았거나 관리 코드를 실행할 수 없는 상태 또는 호출을 처리할 수 없는 상태입니다.
HOST_E_TIMEOUT	호출 시간이 초과되었습니다.
HOST_E_NOT_OWNER	호출자가 잠금을 소유하고 있지 않습니다.
HOST_E_ABANDONED	차단된 스레드나 파이버가 기다리던 이벤트가 취소되었습니다.
E_FAIL	알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환하는 경우 프로세스에서 CLR을 더 이상 사용할 수 없습니다. 이후에 호스팅 메서드를 호출하면 HOST_E_CLRNOTAVAILABLE이 반환됩니다.

설명

GetBindingIdentityFromFile은 일반적으로 두 번 호출됩니다. 처음 호출할 때는 pwzBuffer에 대해 null 값이 제공되고 메서드에서는 pcchBufferSize에 적절한 크기가 반환됩니다. 두 번째 호출할 때는 적절하게 할당된 버퍼가 제공되고, 호출이 완료되면 메서드에서 실제 버퍼 데이터가 반환됩니다.