Função CreatePrivateNamespaceA (winbase.h)
Cria um namespace privado.
Sintaxe
HANDLE CreatePrivateNamespaceA(
[in, optional] LPSECURITY_ATTRIBUTES lpPrivateNamespaceAttributes,
[in] LPVOID lpBoundaryDescriptor,
[in] LPCSTR lpAliasPrefix
);
Parâmetros
[in, optional] lpPrivateNamespaceAttributes
Um ponteiro para uma estrutura SECURITY_ATTRIBUTES que especifica os atributos de segurança do objeto namespace.
[in] lpBoundaryDescriptor
Um descritor que define como o namespace deve ser isolado. O chamador deve estar dentro desse limite. A função CreateBoundaryDescriptor cria um descritor de limite.
[in] lpAliasPrefix
O prefixo do namespace. Para criar um objeto nesse namespace, especifique o nome do objeto como prefixo\objectname.
O sistema dá suporte a vários namespaces privados com o mesmo nome, desde que definam limites diferentes.
Valor de retorno
Se a função for bem-sucedida, ela retornará um identificador para o novo namespace.
Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.
Observações
Outros aplicativos podem acessar o namespace usando a função
O aplicativo que criou o namespace pode usar a função ClosePrivateNamespace para fechar o identificador para o namespace. O identificador também é fechado quando o processo de criação é encerrado. Depois que o identificador do namespace é fechado, as chamadas subsequentes para OpenPrivateNamespace falham, mas todas as operações em objetos no namespace são bem-sucedidas.
Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou posterior.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| servidor com suporte mínimo | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winbase.h (inclua Windows.h) |
| biblioteca | Kernel32.lib |
| de DLL |
Kernel32.dll |