ICLRProbingAssemblyEnum::Get-Methode
Ruft die Assemblyidentität am angegebenen Index ab.
HRESULT Get (
[in] DWORD dwIndex,
[out, size_is(*pcchBufferSize)] LPWSTR pwzBuffer,
[in, out] DWORD *pcchBufferSize
);
Parameter
dwIndex
[in] Der zurückzugebende nullbasierte Index der Assemblyidentität.pwzBuffer
[out] Ein Puffer mit den Assemblyidentitätsdaten.pcchBufferSize
[in, out] Die Größe des pwzBuffer-Puffers.
Rückgabewert
HRESULT |
Beschreibungen |
|---|---|
S_OK |
Get erfolgreich zurückgegeben. |
ERROR_INSUFFICIENT_BUFFER |
pwzBuffer ist zu klein. |
ERROR_NO_MORE_ITEMS |
Die Enumeration enthält keine weiteren Elemente. |
HOST_E_CLRNOTAVAILABLE |
Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann. |
HOST_E_TIMEOUT |
Der Aufruf hat das Zeitlimit überschritten. |
HOST_E_NOT_OWNER |
Der Aufrufer ist nicht Besitzer der Sperre. |
HOST_E_ABANDONED |
Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat. |
E_FAIL |
Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe beliebiger Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück. |
Hinweise
Die Identität am Index 0 (null) entspricht der spezifischen Identität der Prozessorarchitektur. Die Identität am Index 1 entspricht der architekturneutralen Assembly für MSIL (Microsoft Intermediate Language). Die Identität am Index 2 enthält keine Architekturinformationen.
Get wird normalerweise zweimal aufgerufen. Mit dem ersten Aufruf wird ein NULL-Wert für pwzBuffer bereitgestellt, und pcchBufferSize wird auf die für pwzBuffer geeignete Größe festgelegt. Mit dem zweiten Aufruf wird ein pwzBuffer geeigneter Größe bereitgestellt. Außerdem enthält dieser nach Abschluss die kanonischen Daten der Assemblyidentität.
Anforderungen
Plattformen: siehe Systemanforderungen für .NET Framework.
Header: MSCorEE.h
Bibliothek: als Ressource in MSCorEE.dll enthalten
.NET Framework-Versionen: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0