Función CreateVersionStringFromModule

Crea una cadena de versión a partir de una ruta de acceso de Common Language Runtime (CLR) en un proceso de destino.

Sintaxis

HRESULT CreateVersionStringFromModule (
    [in]  DWORD      pidDebuggee,
    [in]  LPCWSTR    szModuleName,
    [out, size_is(cchBuffer),
    length_is(*pdwLength)] LPWSTR Buffer,
    [in]  DWORD      cchBuffer,
    [out] DWORD*     pdwLength
);

Parámetros

pidDebuggee
[in] Identificador del proceso en el que se carga el CLR de destino.

szModuleName
[in] Ruta de acceso completa o relativa al CLR de destino que se carga en el proceso.

pBuffer
[out] Devuelve el búfer para almacenar la cadena de versión del CLR de destino.

cchBuffer
[in] Tamaño de pBuffer.

pdwLength
[out] Longitud de la cadena de versión devuelta por pBuffer.

Valor devuelto

S_OK
La cadena de versión del CLR de destino se devolvió correctamente en pBuffer.

E_INVALIDARG
szModuleName es null o pBuffercchBuffer es NULL. pBuffer y cchBuffer deben ser null o no null.

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
pdwLength es mayor que cchBuffer. Esto puede ser un resultado esperado si ha pasado null para pBuffer y cchBuffery ha consultado el tamaño de búfer necesario mediante pdwLength.

HRESULT_FROM_WIN32(ERROR_MOD_NOT_FOUND)
szModuleName no contiene una ruta de acceso a un CLR válido en el proceso de destino.

E_FAIL (u otros E_ códigos de retorno)
pidDebuggee no hace referencia a un proceso válido u otro error.

Observaciones

Esta función acepta un proceso CLR identificado por pidDebuggee y una ruta de acceso de cadena especificada por szModuleName. La cadena de versión se devuelve en el búfer al que pBuffer apunta. Esta cadena es opaca para el usuario de la función; es decir, no hay ningún significado intrínseco en la propia cadena de versión. Se usa únicamente en el contexto de esta función y en la función CreateDebuggingInterfaceFromVersion.

Se debe llamar a esta función dos veces. Cuando se llama por primera vez, pase null para pBuffer y cchBuffer. Al hacerlo, el tamaño del búfer necesario para pBuffer se devolverá en pdwLength. A continuación, puede llamar a la función una segunda vez y pasar el búfer en pBuffer y su tamaño en cchBuffer.

Requisitos

Plataformas: Consulte Sistemas operativos compatibles con .NET.

Encabezado: dbgshim.h

Biblioteca: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Versiones de .NET: Disponible desde .NET Core 2.1