Função WindowsInspectString (winstring.h)

Fornece uma maneira de os depuradores exibirem o valor de uma Windows Runtime HSTRING em outro espaço de endereço, remotamente ou de um despejo.

Sintaxe

HRESULT WindowsInspectString(
  UINT_PTR                  targetHString,
  USHORT                    machine,
  PINSPECT_HSTRING_CALLBACK callback,
  void                      *context,
  UINT32                    *length,
  UINT_PTR                  *targetStringAddress
);

Parâmetros

targetHString

[in]

O HSTRING a ser inspecionado.

machine

O formato do espaço de endereço de destino. Os valores válidos são IMAGE_FILE_MACHINE_AMD64 para Win64, IMAGE_FILE_MACHINE_I386 para Win32 ou IMAGE_FILE_MACHINE_ARM para ARM de 32 bits.

callback

[in]

Uma função de retorno de chamada para ler o buffer de cadeia de caracteres do espaço de endereço de destino. Essa função é chamada antes que os parâmetros length e targetStringAddress sejam calculados pela função WindowsInspectString .

context

[in, opcional]

Dados de contexto personalizados passados para o retorno de chamada.

length

[out]

O comprimento da cadeia de caracteres no espaço de endereço de destino, se a chamada para retorno de chamada for bem-sucedida; caso contrário, 0.

targetStringAddress

[out]

O endereço de destino do PCWSTR bruto, se a chamada para retorno de chamada for bem-sucedida; caso contrário, NULL.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno	Descrição
E_INVALIDARG	IMAGE_FILE_MACHINE_AMD64 foi especificado para o computador, mas a plataforma atual não é Win64 ou o computador não é IMAGE_FILE_MACHINE_AMD64, IMAGE_FILE_MACHINE_I386 ou IMAGE_FILE_MACHINE_ARM, ou targetHString não é um HSTRING formado corretamente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Plataforma de Destino	Windows
Cabeçalho	winstring.h
Biblioteca	RuntimeObject.lib
DLL	ComBase.dll

Confira também

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString