Compartilhar via


Método CInstance::GetWCHAR (instance.h)

[A classe CInstance faz parte do WMI Provider Framework que agora é considerado em estado final e nenhum desenvolvimento, melhoria ou atualização adicional estará disponível para problemas não relacionados à segurança que afetarem essas bibliotecas. As APIs de MI devem ser usadas para todos os novos desenvolvimentos.]

O método GetWCHAR recupera uma propriedade de cadeia de caracteres WCHAR .

Sintaxe

bool GetWCHAR(
  LPCWSTR name,
  LPWSTR  *pW
);

Parâmetros

name

Nome da propriedade de cadeia de caracteres WCHAR recuperada.

pW

Buffer que recebe a propriedade de cadeia de caracteres WCHAR .

Valor retornado

Retorna TRUE se a operação foi bem-sucedida e FALSE se foi feita uma tentativa de recuperar uma propriedade que não é um tipo compatível com cadeia de caracteres WCHAR ou uma propriedade que não existe. Mais informações estão disponíveis no arquivo de log Framework.log.

Comentários

É responsabilidade do implementador liberar a memória ocupada pela cadeia de caracteres WCHAR :

    free(pw);

Use gratuito em vez de excluir porque a estrutura do provedor aloca a cadeia de caracteres usando malloc e não usa o novo operador.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho instance.h (inclua FwCommon.h)
Biblioteca FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll