Método IPortableDeviceValues::GetStringValue

O método GetStringValue recupera um valor de cadeia de caracteres (tipo VT_LPWSTR) especificado por uma chave.

Sintaxe

HRESULT GetStringValue(
  [in]  REFPROPERTYKEY key,
  [out] LPWSTR         *pValue
);

chave [in]: Uma chave REFPROPERTYKEY que especifica o item a ser recuperado.
pValue [out]: Ponteiro para o valor LPWSTR recuperado. O chamador é responsável por chamar CoTaskMemFree para liberar a memória.

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
DISP_E_TYPEMISMATCH	A propriedade especificada por chave não é um tipo LPWSTR .
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	A propriedade especificada por chave não está na coleção.

Para obter um exemplo de como usar esse método, consulte Recuperando eventos de serviço com suporte.

Requisito	Valor
parâmetro	PortableDeviceTypes.h
Biblioteca	PortableDeviceGUIDs.lib