Función AllocCountedString
Nota
La plataforma protección de acceso a redes no está disponible a partir de Windows 10
La función AllocCountedString asigna memoria para una cadena terminada en null y la devuelve en una estructura CountedString .
Sintaxis
NAPAPI HRESULT WINAPI AllocCountedString(
_Inout_ CountedString **countedString,
_In_ const WCHAR *string
);
Parámetros
-
countedString [in, out]
-
Puntero a la dirección de una estructura CountedString recién asignada.
-
string [in]
-
Puntero a la cadena terminada en null que se va a devolver en countedString.
Valor devuelto
| Código devuelto | Descripción |
|---|---|
|
La operación se ha completado correctamente. |
|
Se pasó un argumento no válido. |
|
El sistema no tiene memoria virtual. Se ha producido un error en esta operación. |
Observaciones
Todas las interfaces COM compatibles con el sistema NAP usan reglas de administración de memoria COM estándar y los asignadores de memoria COM (CoTaskMemAlloc y CoTaskMemFree):
- En los parámetros, el autor de la llamada asigna y libera.
- El autor de la llamada asigna los parámetros out y los libera mediante CoTaskMem.
- El autor de la llamada asigna los parámetros de entrada y salida, liberados y reasignados por el autor de la llamada y, en última instancia, liberados por el autor de la llamada, mediante CoTaskMem.
Todas las funciones NAP para liberar memoria también liberan todos los punteros incrustados.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado |
|
| Archivo DLL |
|