Partager via

Fonction AllocCountedString

  • Article

Notes

La plateforme protection de l’accès réseau n’est pas disponible à partir de Windows 10

La fonction AllocCountedString alloue de la mémoire pour une chaîne terminée par null et la retourne dans une structure CountedString .

Syntaxe

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

Paramètres

countedString [in, out]

Pointeur vers l’adresse d’une structure CountedString nouvellement allouée.

string [in]

Pointeur vers la chaîne terminée par null qui doit être retournée dans countedString.

Valeur retournée

Code de retour Description
S_OK
 L’opération s’est terminée avec succès.
E_INVALIDARG
 Un argument non valide a été passé.
E_OUTOFMEMORY
 La mémoire virtuelle du système est insuffisante. Cette opération a échoué.

Notes

Toutes les interfaces COM prises en charge par le système NAP utilisent des règles de gestion de la mémoire COM standard et les allocateurs de mémoire COM (CoTaskMemAlloc et CoTaskMemFree) :

  • Dans les paramètres sont alloués et libérés par l’appelant.
  • Les paramètres out sont alloués par l’appelé et libérés par l’appelant à l’aide de CoTaskMem.
  • Les paramètres d’entrée/sortie sont alloués par l’appelant, libérés et réalloués par l’appelé, puis libérés par l’appelant, à l’aide de CoTaskMem.

Toutes les fonctions NAP pour libérer de la mémoire libèrent également tous les pointeurs incorporés.

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows Server 2008 [applications de bureau uniquement]
En-tête
NapUtil.h
DLL
Qutil.dll

Voir aussi

FreeCountedString