IIisServiceControl::Status

  • Article

The IIisServiceControl::Status method returns the status of all Internet services (all services dependent on IISADMIN) as an array of ENUM_SERVICE_STATUS.

STDMETHODIMP Status(
      DWORD dwBufferSize,
      unsigned char* pbBuffer,
      DWORD* pdwMDRequiredBufferSize,
      DWORD* pdwNumServices
);

Parameters

  • dwBufferSize
    The maximum size of pbBuffer.

  • pbBuffer
    A buffer filled with serialized status as an array of SERIALIZED_ENUM_SERVICE_STATUS.

  • pdwMDRequiredBufferSize
    Updated with the required size if dwBufferSize is too small.

  • pdwNumServices
    Updated with the number of entries stored in pbBuffer.

Return Values

If access to restart commands are disabled, this method returns ERROR_RESOURCE_DISABLED. If dwBufferSize is too small, this method returns ERROR_INSUFFICIENT_BUFFER. Otherwise, COM status is returned.

Requirements

Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

Header: Declared in iisrsta.h.