Funzione CreatePrivateNamespaceA (winbase.h)
Crea uno spazio dei nomi privato.
Sintassi
HANDLE CreatePrivateNamespaceA(
[in, optional] LPSECURITY_ATTRIBUTES lpPrivateNamespaceAttributes,
[in] LPVOID lpBoundaryDescriptor,
[in] LPCSTR lpAliasPrefix
);
Parametri
[in, optional] lpPrivateNamespaceAttributes
Puntatore a una struttura SECURITY_ATTRIBUTES che specifica gli attributi di sicurezza dell'oggetto spazio dei nomi.
[in] lpBoundaryDescriptor
Descrittore che definisce come lo spazio dei nomi deve essere isolato. Il chiamante deve trovarsi all'interno di questo limite. La funzione CreateBoundaryDescriptor crea un descrittore limite.
[in] lpAliasPrefix
Prefisso per lo spazio dei nomi. Per creare un oggetto in questo spazio dei nomi, specificare il nome dell'oggetto comenome oggettoprefisso\.
Il sistema supporta più spazi dei nomi privati con lo stesso nome, purché definiscano limiti diversi.
Valore restituito
Se la funzione ha esito positivo, restituisce un handle al nuovo spazio dei nomi.
Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Altre applicazioni possono accedere allo spazio dei nomi usando la funzione OpenPrivateNamespace .
L'applicazione che ha creato lo spazio dei nomi può usare la funzione ClosePrivateNamespace per chiudere l'handle allo spazio dei nomi. L'handle viene chiuso anche al termine del processo di creazione. Dopo la chiusura dell'handle dello spazio dei nomi, le chiamate successive a OpenPrivateNamespace hanno esito negativo, ma tutte le operazioni sugli oggetti nello spazio dei nomi hanno esito positivo.
Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versioni successive.
Requisiti
| Client minimo supportato | Windows Vista [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2008 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |