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 retornado

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.

Comentários

Outros aplicativos podem acessar o namespace usando a função OpenPrivateNamespace .

O aplicativo que criou o namespace pode usar a função ClosePrivateNamespace para fechar o identificador do namespace. O identificador também é fechado quando o processo de criação é encerrado. Depois que o identificador de 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

Confira também

ClosePrivateNamespace

Namespaces de objeto

OpenPrivateNamespace