Compartilhar via


Método IPortableDeviceValues::SetStringValue

O método SetStringValue adiciona um novo valor de cadeia de caracteres (tipo VT_LPWSTR) ou substitui um existente.

Sintaxe

HRESULT SetStringValue(
  [in] REFPROPERTYKEY key,
  [in] LPCWSTR        Value
);

Parâmetros

chave [in]

Um REFPROPERTYKEY que especifica o item a ser criado ou substituído.

Valor [in]

Um LPCWSTR que especifica o novo valor. A cadeia de caracteres é copiada, para que o chamador possa liberar a memória alocada para esse valor depois de chamar esse método.

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.

Comentários

Qualquer memória de chave existente será liberada adequadamente.

Exemplos

Para obter um exemplo de como usar esse método, consulte Especificando informações do cliente.

Requisitos

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

Confira também

Adicionando um recurso a um objeto

IPortableDeviceValues Interface

IPortableDeviceValues::GetStringValue

Definindo propriedades para um único objeto

Definindo propriedades para vários objetos

Especificando informações do cliente

Gravando propriedades de objeto de conteúdo