Compartilhar via

Função AllocCountedString

  • Artigo

Observação

A plataforma de Proteção de Acesso à Rede não está disponível a partir do Windows 10

A função AllocCountedString aloca memória para uma cadeia de caracteres terminada em nulo e a retorna em uma estrutura CountedString .

Sintaxe

NAPAPI HRESULT WINAPI AllocCountedString(
  _Inout_       CountedString **countedString,
  _In_    const WCHAR         *string
);

Parâmetros

countedString [in, out]

Um ponteiro para o endereço de uma estrutura CountedString recém-alocada.

cadeia de caracteres [in]

Um ponteiro para a cadeia de caracteres terminada em nulo que deve ser retornada em countedString.

Valor retornado

Código de retorno Descrição
S_OK
 A operação foi concluída com êxito.
E_INVALIDARG
 Um argumento inválido foi passado.
E_OUTOFMEMORY
 O sistema está sem memória virtual. Esta operação falhou.

Comentários

Todas as interfaces COM compatíveis com o sistema NAP usam regras de gerenciamento de memória COM padrão e alocadores de memória COM (CoTaskMemAlloc e CoTaskMemFree):

  • Os parâmetros em são alocados e liberados pelo chamador.
  • Os parâmetros out são alocados pelo destinatário do chamador e liberados pelo chamador usando CoTaskMem.
  • Os parâmetros de entrada/saída são alocados pelo chamador, liberados e realocados pelo destinatário do chamador e, por fim, liberados pelo chamador, usando CoTaskMem.

Todas as funções NAP para liberar memória também liberam todos os ponteiros inseridos.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho
NapUtil.h
DLL
Qutil.dll

Confira também

FreeCountedString