AllocCountedString, fonction

  • Article
  • 2 minutes de lecture

Notes

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

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

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
 Le système est hors mémoire virtuelle. 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 mémoire COM standard et les allocateurs de mémoire COM (CoTaskMemAlloc et CoTaskMemFree) :

  • Les paramètres sont alloués et libérés par l’appelant.
  • Les paramètres sortants sont alloués par l’appelant 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éaffectés par l’appelant, et finalement 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 Value
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