Compartilhar via


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
);

Parâmetros

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.

Valor retornado

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.

Exemplos

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

Requisitos

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

Confira também

IPortableDeviceValues Interface

IPortableDeviceValues::GetAt

IPortableDeviceValues::SetStringValue

Recuperando eventos de serviço com suporte

Recuperando formatos de serviço com suporte

Recuperando métodos de serviço com suporte