Función CreateVersionStringFromModule

Artículo
09/22/2023

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] Búfer de retorno 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 bien pBuffer o cchBuffer es NULL. pBuffer y cchBuffer deben ser ambos NULL o no NULL.

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
pdwLength es mayor que cchBuffer. Este puede ser el resultado esperado si pasó NULL tanto para pBuffer como para cchBuffer, y consultó el tamaño del búfer necesario usando 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 códigos de retorno E_)
pidDebuggee no hace referencia a un proceso válido, u otro error.

Comentarios

Esta función acepta un proceso de CLR que se identifica mediante 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 tiene ningún significado intrínseco en la propia cadena de versión. Se usa únicamente en el contexto de esta función y de la función CreateDebuggingInterfaceFromVersion.

Se debe llamar dos veces a esta función. Cuando la llame por primera vez, pase NULL tanto para pBuffer como para cchBuffer. Al hacerlo, el tamaño del búfer necesario para pBuffer se devuelve en pdwLength. Después 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 a partir de .NET Core 2.1

Compartir a través de