3.1.4 Higher-Layer Triggered Events

There is a one-to-one correspondence between higher-layer triggered events and commands specified in section 2.3. When a higher layer requests a particular action, the associated command MUST be passed to the Remote Administration Protocol with all of the values specified by the higher layer. Details of the parameters supplied by the higher layer are specified in the request structure for the command in section 2.5.1. The client MUST propagate the values provided by the calling application, and it MUST fail the call if the parameters required are not provided or if an illegal InfoLevel is provided.

The client MUST create a Remote Administration Protocol request message, as specified in section 2.5.1, for the command corresponding to the requested operation. If a value is not specified for ParamDesc, DataDesc, or AuxDesc in the corresponding section, the field MUST NOT be transmitted with the request.

The client MUST then submit an SMB_COM_TRANSACTION request (which contains the Remote Administration Protocol request) to the server.

If the client receives ERROR_MORE_DATA or NERR_BufTooSmall (0x084B) for the following commands, and it is enumerating the remaining available data from the server, then the client MUST reissue the command with the buffer size set to the value of the TotalBytesAvailable field from the failed response, or set to the value obtained by multiplying the EntriesAvailable count of the response by the defined structure size.

  • NetShareEnum

  • NetServerGetInfo

  • NetPrintQEnum

  • NetPrintQGetInfo

  • NetUserGetInfo

  • NetPrintJobGetInfo

  • NetServerEnum2

  • NetServerEnum3

  • NetWkstaGetInfo

  • NetShareGetInfo