Funzione CreatePrivateNamespaceA (winbase.h)

Articolo
11/20/2024

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 la modalità di isolamento dello spazio dei nomi. 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 come prefisso \nomeoggetto.

Il sistema supporta più spazi dei nomi privati con lo stesso nome, purché definisci 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 quando termina il 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 versione successiva.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [app desktop \| App UWP]
server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	winbase.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

ClosePrivateNamespace

spazi dei nomi degli oggetti

OpenPrivateNamespace

Condividi tramite