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

Vedere anche

ClosePrivateNamespace

Spazi dei nomi degli oggetti

OpenPrivateNamespace