Partager via

3.1.4.46 NetrServerAliasDel (Opnum 56)

  • Article

The NetrServerAliasDel method deletes an alias name from a server alias list based on specified alias name.

 NET_API_STATUS NetrServerAliasDel(
   [in, string, unique] SRVSVC_HANDLE ServerName,
   [in] DWORD Level,
   [in, switch_is(Level)] LPSERVER_ALIAS_INFO InfoStruct
 );

ServerName: An SRVSVC_HANDLE (section 2.2.1.1) pointer that identifies the server. The client MUST map this structure to an RPC binding handle ([C706] sections 4.3.5 and 5.1.5.2). If this parameter is NULL, the local computer is used.

Level: Specifies the information level of the data. It MUST be one of the following values.

Value

Meaning

0

The buffer is of type SERVER_ALIAS_INFO_0_CONTAINER.

InfoStruct: A pointer to the SERVER_ALIAS_INFO union that contains information about the alias. The value of the Level parameter determines the type of the contents of the InfoStruct parameter, as the preceding table shows.

Return Values: The method returns 0x00000000 (NERR_Success) to indicate success; otherwise, it returns a nonzero error code. The method can take any specific error code value, as specified in [MS-ERREF] section 2.2. The most common error codes are listed in the following table.

Return value/code

Description

0x00000000

NERR_Success

The client request succeeded.

0x00000005

ERROR_ACCESS_DENIED

Access is denied.

0x00000057

ERROR_INVALID_PARAMETER

The client request failed because the specified parameter is invalid.

0x00000008

ERROR_NOT_ENOUGH_MEMORY

Not enough storage is available to process this command.

0x00000906

NERR_NetNameNotFound

The alias does not exist.

0x0000007C

ERROR_INVALID_LEVEL

The system call level is not correct.

In response to a NetrServerAliasDel message, the server MUST delete the alias name from the AliasList based on specified alias name, or MUST return an error code.

The srvai*_alias parameter specifies the name of the alias to be deleted. This MUST be a nonempty null-terminated UTF-16 string if srvai*_default is 0 or empty string if srvai*_default is nonzero; otherwise, the server MUST fail the call with an ERROR_INVALID_PARAMETER error code.

If no alias matching srvai*_alias exists, the server fails the call with a NERR_NetNameNotFound error code.

srvai*_target MUST be ignored by the server.

The server SHOULD<175> enforce security measures to verify that the caller has the required permissions to execute this routine. If the caller does not have the required credentials, the server SHOULD<176> fail the call.

The server MUST delete configuration data for this alias from the persistent configuration store.