Platform SDK: Remote Procedure Call

RpcNsProfileDelete

The RpcNsProfileDelete function deletes a profile attribute.

RPC_STATUS RPC_ENTRY RpcNsProfileDelete(
  unsigned long ProfileNameSyntax,
  unsigned char *ProfileName
);

Parameters

ProfileNameSyntax: Specifies an integer value that indicates the syntax of the next argument, ProfileName.
To use the syntax specified in the registry value HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\
DefaultSyntax, provide a value of RPC_C_NS_SYNTAX_DEFAULT.
ProfileName: Pointer to the name of the profile to delete.

Return Values

Value	Meaning
RPC_S_OK	Call successful.
RPC_S_INVALID_NAME_SYNTAX	Invalid name syntax.
RPC_S_UNSUPPORTED_NAME_SYNTAX	Unsupported name syntax.
RPC_S_INCOMPLETE_NAME	Incomplete name.
RPC_S_ENTRY_NOT_FOUND	Name-service entry not found.
RPC_S_NAME_SERVICE_UNAVAILABLE	Name service unavailable.

Remarks

The RpcNsProfileDelete function deletes the profile attribute from the specified name-service entry (ProfileName). Neither ProfileName nor the entry names included as members in each profile element are deleted.

Tip Use RpcNsProfileDelete cautiously; deleting a profile can have the unwanted effect of breaking a hierarchy of profiles.

Note This DCE function is not supported by Microsoft Locator. Windows NT and Windows 2000 support the use of this function with Cell Directory Service (CDS) only.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Rpcnsi.h.
  Library: Use Rpcns4.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.

RpcNsProfileDelete

Parameters

Return Values

Remarks

Requirements

See Also