Metodo ICLRAssemblyIdentityManager::GetBindingIdentityFromFile

Articolo
08/11/2011

Ottiene i dati di associazione dell'identità per l'assembly nel percorso file specificato.

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

Parametri

pwzFilePath
[in] Percorso del file da valutare.
dwFlags
[in] Valore dell'enumerazione ECLRAssemblyIdentityFlags che indica il tipo di identità di un assembly. Fornito per una futura estensibilità. CLR_ASSEMBLY_IDENTITY_FLAGS_DEFAULT è l'unico valore supportato dalla versione 2.0 di Common Language Runtime.
pwzBuffer
[out] Buffer contenente i dati dell'identità assembly opaca.
pcchBufferSize
[in, out] Puntatore alla dimensione di pwzBuffer.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	Il metodo ha restituito correttamente un valore.
E_INVALIDARG	Il valore del parametro pwzFilePath fornito è null.
ERROR_INSUFFICIENT_BUFFER	La dimensione di pwzBuffer è troppo piccola.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non è il proprietario del blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, Common Language Runtime non sarà più utilizzabile all'interno del processo. Le successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.

Note

Il metodo GetBindingIdentityFromFile viene in genere chiamato due volte. Nella prima chiamata viene fornito un valore null per il parametro pwzBuffer, quindi il metodo restituisce la dimensione appropriata nel parametro pcchBufferSize. Nella seconda chiamata viene fornito un buffer correttamente allocato e al termine dell'operazione il metodo restituisce i dati effettivi del buffer.