iiisservicecontrol

package
v1.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 13, 2024 License: MIT Imports: 10 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var (
	// IIisServiceControl interface identifier e8fb8620-588f-11d2-9d61-00c04f79c5fe
	IISServiceControlIID = &dcom.IID{Data1: 0xe8fb8620, Data2: 0x588f, Data3: 0x11d2, Data4: []byte{0x9d, 0x61, 0x00, 0xc0, 0x4f, 0x79, 0xc5, 0xfe}}
	// Syntax UUID
	IISServiceControlSyntaxUUID = &uuid.UUID{TimeLow: 0xe8fb8620, TimeMid: 0x588f, TimeHiAndVersion: 0x11d2, ClockSeqHiAndReserved: 0x9d, ClockSeqLow: 0x61, Node: [6]uint8{0x0, 0xc0, 0x4f, 0x79, 0xc5, 0xfe}}
	// Syntax ID
	IISServiceControlSyntaxV0_0 = &dcerpc.SyntaxID{IfUUID: IISServiceControlSyntaxUUID, IfVersionMajor: 0, IfVersionMinor: 0}
)
View Source 
var (
	// import guard
	GoPackage = "dcom/iiss"
)

Functions

func IISServiceControlServerHandle 

func IISServiceControlServerHandle(ctx context.Context, o IISServiceControlServer, opNum int, r ndr.Reader) (dcerpc.Operation, error)

func NewIISServiceControlServerHandle 

func NewIISServiceControlServerHandle(o IISServiceControlServer) dcerpc.ServerHandle

func RegisterIISServiceControlServer 

func RegisterIISServiceControlServer(conn dcerpc.Conn, o IISServiceControlServer, opts ...dcerpc.Option)

Types

type IISServiceControlClient 

type IISServiceControlClient interface {

	// IDispatch retrieval method.
	Dispatch() idispatch.DispatchClient

	// This method stops any running Internet services.<3>
	//
	// The server can have all functionality through this interface disabled using actions
	// taken local to the server machine. In this case the function MUST return an error
	// when called (E_ERROR_RESOURCE_DISABLED) and MUST NOT perform any other action.
	//
	// If the interface functionality is not disabled, the following actions SHOULD take
	// place on the server when this method is called:
	//
	// * The method SHOULD first attempt a graceful stop ( 546d32cd-905e-4f34-b023-2be4b5e16413#gt_7ea63e69-1023-48fd-bd40-f3729a350c06
	// ) of the services. If the caller has requested that the services be forced to stop
	// and the code either fails to request the stops or times out (based on the dwTimeoutMsecs
	// parameter) while waiting for the services to stop, it SHOULD terminate the processes
	// to ensure that they stop. This procedure SHOULD use the *Kill* ( 10ffdf93-a56f-4fc8-a3fd-5076135bc33b
	// ) method, as specified in section *3.1.4.5* , to handle the forced termination. <4>
	// ( 5c517f8f-7847-402a-b79e-4dbbf517997e#Appendix_A_4 )
	//
	// HRESULT Stop(
	//
	// DWORD dwTimeoutMsecs,
	//
	// # DWORD dwForce
	//
	// );
	//
	// Return Values: A signed, 32-bit value indicating return status. If the method returns
	// a negative value, it has failed. If the 12-bit facility code (bits 16–27) is set
	// to 0x007, the value contains a Win32 error code in the lower 16 bits. 0 or positive
	// values indicate success, with the lower 16 bits in positive nonzero values containing
	// warnings or flags defined in the method implementation. For more information about
	// HRESULT, see [MS-ERREF] section 2.1.
	//
	// The method MUST return S_OK (0x00000000) upon success.
	//
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	|                   RETURN                   |                                                                                |
	//	|                 VALUE/CODE                 |                                  DESCRIPTION                                   |
	//	|                                            |                                                                                |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x00000000 S_OK                            | The call was successful.                                                       |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x80070008 E_ERROR_NOT_ENOUGH_MEMORY       | Not enough memory is available to process this command.                        |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x8007041D E_ERROR_SERVICE_REQUEST_TIMEOUT | A time-out has occurred while waiting for the Internet services to be stopped. |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x800710D5 E_ERROR_RESOURCE_DISABLED       | The IIisServiceControl interface is disabled.                                  |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//
	// If the length of time specified by dwTimeoutMsecs has elapsed and not all services
	// have stopped, and if dwForce is set to 0x00000001 (True), then the remaining services
	// SHOULD be forced to terminate.
	Stop(context.Context, *StopRequest, ...dcerpc.CallOption) (*StopResponse, error)

	// This method is used to start the Internet services.
	//
	// The server can have all functionality through this interface disabled using actions
	// taken local to the server. In this case the function MUST return an error when called
	// (E_ERROR_RESOURCE_DISABLED) and MUST NOT perform any other action.
	//
	// If the interface functionality is not disabled, the following SHOULD take place on
	// the server when this method is called:
	//
	// * The method SHOULD <5> ( 5c517f8f-7847-402a-b79e-4dbbf517997e#Appendix_A_5 ) start
	// all Internet services that are marked to start automatically when the computer starts
	// up.
	//
	// HRESULT Start(
	//
	// # DWORD dwTimeoutMsecs
	//
	// );
	//
	// Return Values: A signed, 32-bit value indicating return status. If the method returns
	// a negative value, it has failed. If the 12-bit facility code (bits 16–27) is set
	// to 0x007, the value contains a Win32 error code in the lower 16 bits. 0 or positive
	// values indicate success, with the lower 16 bits in positive nonzero values containing
	// warnings or flags defined in the method implementation. For more information about
	// HRESULT, see [MS-ERREF] section 2.1.
	//
	// The method MUST return S_OK (0x00000000) upon success.
	//
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	|                   RETURN                   |                                                                                |
	//	|                 VALUE/CODE                 |                                  DESCRIPTION                                   |
	//	|                                            |                                                                                |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x00000000 S_OK                            | The call was successful.                                                       |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x80070008 E_ERROR_NOT_ENOUGH_MEMORY       | Not enough memory is available to process this command.                        |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x8007041D E_ERROR_SERVICE_REQUEST_TIMEOUT | A time-out has occurred while waiting for all Internet services to be started. |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x800710D5 E_ERROR_RESOURCE_DISABLED       | The IIisServiceControl Interface is disabled.                                  |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	Start(context.Context, *StartRequest, ...dcerpc.CallOption) (*StartResponse, error)

	// This method is used to reboot the computer where the IIS service is running.
	//
	// The server implementation MAY<6> not implement this function. If it does not, then
	// it MUST return E_NOTIMPL.
	//
	// Return Values: A signed, 32-bit value indicating return status. If the method returns
	// a negative value, it has failed. If the 12-bit facility code (bits 16–27) is set
	// to 0x007, the value contains a Win32 error code in the lower 16 bits. 0 or positive
	// values indicate success, with the lower 16 bits in positive nonzero values containing
	// warnings or flags defined in the method implementation. For more information about
	// HRESULT, see [MS-ERREF] section 2.1.
	//
	// The method MUST return S_OK (0x00000000) upon success.
	//
	//	+--------------------------------------+----------------------------------------------------------------+
	//	|                RETURN                |                                                                |
	//	|              VALUE/CODE              |                          DESCRIPTION                           |
	//	|                                      |                                                                |
	//	+--------------------------------------+----------------------------------------------------------------+
	//	+--------------------------------------+----------------------------------------------------------------+
	//	| 0x00000000 S_OK                      | The call was successful.                                       |
	//	+--------------------------------------+----------------------------------------------------------------+
	//	| 0x80070008 E_ERROR_NOT_ENOUGH_MEMORY | Not enough memory is available to process this command.        |
	//	+--------------------------------------+----------------------------------------------------------------+
	//	| 0x800710D5 E_ERROR_RESOURCE_DISABLED | The IIisServiceControl interface is disabled.                  |
	//	+--------------------------------------+----------------------------------------------------------------+
	//	| 0x80004001 E_NOTIMPL                 | This function is not supported for this version of the server. |
	//	+--------------------------------------+----------------------------------------------------------------+
	Reboot(context.Context, *RebootRequest, ...dcerpc.CallOption) (*RebootResponse, error)

	// This method returns the status of the Internet services.
	//
	// The server can have all functionality through this interface disabled using actions
	// taken local to the server machine. In this case the function MUST return an error
	// when called (E_ERROR_RESOURCE_DISABLED) and MUST NOT perform any other action.
	//
	// If the interface functionality is not disabled, the following SHOULD take place on
	// the server when this method is called:
	//
	// * The method SHOULD return a buffer of unsigned chars as described in section 2.2.2
	// ( 096ffe89-76be-4d01-9e4d-f68428a231fc ). This buffer of unsigned chars MUST contain
	// data about the status of the Internet services.
	//
	// * If it is not possible to return all the data in the buffer provided, then the following
	// conditional behavior MUST occur.
	//
	// For more information about the unsigned char buffer returned, see section 2.2.2.
	//
	// Return Values: A signed, 32-bit value indicating return status. If the method returns
	// a negative value, it has failed. If the 12-bit facility code (bits 16–27) is set
	// to 0x007, the value contains a Win32 error code in the lower 16 bits. 0 or positive
	// values indicate success, with the lower 16 bits in positive nonzero values containing
	// warnings or flags defined in the method implementation. For more information about
	// HRESULT, see [MS-ERREF] section 2.1.
	//
	// The method MUST return S_OK (0x00000000) upon success.
	//
	//	+----------------------------------------+----------------------------------------------------------------------------------+
	//	|                 RETURN                 |                                                                                  |
	//	|               VALUE/CODE               |                                   DESCRIPTION                                    |
	//	|                                        |                                                                                  |
	//	+----------------------------------------+----------------------------------------------------------------------------------+
	//	+----------------------------------------+----------------------------------------------------------------------------------+
	//	| 0x00000000 S_OK                        | The call was successful.                                                         |
	//	+----------------------------------------+----------------------------------------------------------------------------------+
	//	| 0x8007007A E_ERROR_INSUFFICIENT_BUFFER | The size of the pbBuffer is too small to return the status data based on its     |
	//	|                                        | size being declared in dwBufferSize parameter.                                   |
	//	+----------------------------------------+----------------------------------------------------------------------------------+
	//	| 0x80070008 E_ERROR_NOT_ENOUGH_MEMORY   | Not enough memory is available to process this command.                          |
	//	+----------------------------------------+----------------------------------------------------------------------------------+
	//	| 0x800710D5 E_ERROR_RESOURCE_DISABLED   | The IIisServiceControl interface is disabled.                                    |
	//	+----------------------------------------+----------------------------------------------------------------------------------+
	Status(context.Context, *StatusRequest, ...dcerpc.CallOption) (*StatusResponse, error)

	// This method is used to terminate the Internet services processes. This erases the
	// IIS processes from memory, and is used to recover from failed instances of IIS processes.
	//
	// The server can have all functionality through this interface disabled using actions
	// taken local to the server machine. In this case the function MUST return an error
	// when called (E_ERROR_RESOURCE_DISABLED) and MUST NOT perform any other action.
	//
	// If the interface functionality is not disabled, the following SHOULD take place on
	// the server when this method is called:
	//
	// * The method SHOULD terminate all processes involved in supporting the Internet services
	// on the server.
	//
	// How the processes are terminated is implementation-dependent.<7>
	//
	// This method has no parameters.
	//
	// Return Values: A signed, 32-bit value indicating return status. If the method returns
	// a negative value, it has failed. If the 12-bit facility code (bits 16–27) is set
	// to 0x007, the value contains a Win32 error code in the lower 16 bits. 0 or positive
	// values indicate success, with the lower 16 bits in positive nonzero values containing
	// warnings or flags defined in the method implementation. For more information about
	// HRESULT, see [MS-ERREF] section 2.1.
	//
	// Each of the values that follow where the first byte contains 0x8007 is the HRESULT
	// derived from the Win32 error code with the specified name.
	//
	// The method MUST return S_OK (0x00000000) upon success.
	//
	//	+--------------------------------------+---------------------------------------------------------+
	//	|                RETURN                |                                                         |
	//	|              VALUE/CODE              |                       DESCRIPTION                       |
	//	|                                      |                                                         |
	//	+--------------------------------------+---------------------------------------------------------+
	//	+--------------------------------------+---------------------------------------------------------+
	//	| 0x00000000 S_OK                      | The call was successful.                                |
	//	+--------------------------------------+---------------------------------------------------------+
	//	| 0x80070008 E_ERROR_NOT_ENOUGH_MEMORY | Not enough memory is available to process this command. |
	//	+--------------------------------------+---------------------------------------------------------+
	//	| 0x800710D5 E_ERROR_RESOURCE_DISABLED | The IIisServiceControl interface is disabled.           |
	//	+--------------------------------------+---------------------------------------------------------+
	Kill(context.Context, *KillRequest, ...dcerpc.CallOption) (*KillResponse, error)

	// AlterContext alters the client context.
	AlterContext(context.Context, ...dcerpc.Option) error

	// IPID sets the object interface identifier.
	IPID(context.Context, *dcom.IPID) IISServiceControlClient
}

IIisServiceControl interface.

func NewIISServiceControlClient 

func NewIISServiceControlClient(ctx context.Context, cc dcerpc.Conn, opts ...dcerpc.Option) (IISServiceControlClient, error)

type IISServiceControlServer 

type IISServiceControlServer interface {

	// IDispatch base class.
	idispatch.DispatchServer

	// This method stops any running Internet services.<3>
	//
	// The server can have all functionality through this interface disabled using actions
	// taken local to the server machine. In this case the function MUST return an error
	// when called (E_ERROR_RESOURCE_DISABLED) and MUST NOT perform any other action.
	//
	// If the interface functionality is not disabled, the following actions SHOULD take
	// place on the server when this method is called:
	//
	// * The method SHOULD first attempt a graceful stop ( 546d32cd-905e-4f34-b023-2be4b5e16413#gt_7ea63e69-1023-48fd-bd40-f3729a350c06
	// ) of the services. If the caller has requested that the services be forced to stop
	// and the code either fails to request the stops or times out (based on the dwTimeoutMsecs
	// parameter) while waiting for the services to stop, it SHOULD terminate the processes
	// to ensure that they stop. This procedure SHOULD use the *Kill* ( 10ffdf93-a56f-4fc8-a3fd-5076135bc33b
	// ) method, as specified in section *3.1.4.5* , to handle the forced termination. <4>
	// ( 5c517f8f-7847-402a-b79e-4dbbf517997e#Appendix_A_4 )
	//
	// HRESULT Stop(
	//
	// DWORD dwTimeoutMsecs,
	//
	// # DWORD dwForce
	//
	// );
	//
	// Return Values: A signed, 32-bit value indicating return status. If the method returns
	// a negative value, it has failed. If the 12-bit facility code (bits 16–27) is set
	// to 0x007, the value contains a Win32 error code in the lower 16 bits. 0 or positive
	// values indicate success, with the lower 16 bits in positive nonzero values containing
	// warnings or flags defined in the method implementation. For more information about
	// HRESULT, see [MS-ERREF] section 2.1.
	//
	// The method MUST return S_OK (0x00000000) upon success.
	//
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	|                   RETURN                   |                                                                                |
	//	|                 VALUE/CODE                 |                                  DESCRIPTION                                   |
	//	|                                            |                                                                                |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x00000000 S_OK                            | The call was successful.                                                       |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x80070008 E_ERROR_NOT_ENOUGH_MEMORY       | Not enough memory is available to process this command.                        |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x8007041D E_ERROR_SERVICE_REQUEST_TIMEOUT | A time-out has occurred while waiting for the Internet services to be stopped. |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x800710D5 E_ERROR_RESOURCE_DISABLED       | The IIisServiceControl interface is disabled.                                  |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//
	// If the length of time specified by dwTimeoutMsecs has elapsed and not all services
	// have stopped, and if dwForce is set to 0x00000001 (True), then the remaining services
	// SHOULD be forced to terminate.
	Stop(context.Context, *StopRequest) (*StopResponse, error)

	// This method is used to start the Internet services.
	//
	// The server can have all functionality through this interface disabled using actions
	// taken local to the server. In this case the function MUST return an error when called
	// (E_ERROR_RESOURCE_DISABLED) and MUST NOT perform any other action.
	//
	// If the interface functionality is not disabled, the following SHOULD take place on
	// the server when this method is called:
	//
	// * The method SHOULD <5> ( 5c517f8f-7847-402a-b79e-4dbbf517997e#Appendix_A_5 ) start
	// all Internet services that are marked to start automatically when the computer starts
	// up.
	//
	// HRESULT Start(
	//
	// # DWORD dwTimeoutMsecs
	//
	// );
	//
	// Return Values: A signed, 32-bit value indicating return status. If the method returns
	// a negative value, it has failed. If the 12-bit facility code (bits 16–27) is set
	// to 0x007, the value contains a Win32 error code in the lower 16 bits. 0 or positive
	// values indicate success, with the lower 16 bits in positive nonzero values containing
	// warnings or flags defined in the method implementation. For more information about
	// HRESULT, see [MS-ERREF] section 2.1.
	//
	// The method MUST return S_OK (0x00000000) upon success.
	//
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	|                   RETURN                   |                                                                                |
	//	|                 VALUE/CODE                 |                                  DESCRIPTION                                   |
	//	|                                            |                                                                                |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x00000000 S_OK                            | The call was successful.                                                       |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x80070008 E_ERROR_NOT_ENOUGH_MEMORY       | Not enough memory is available to process this command.                        |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x8007041D E_ERROR_SERVICE_REQUEST_TIMEOUT | A time-out has occurred while waiting for all Internet services to be started. |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	//	| 0x800710D5 E_ERROR_RESOURCE_DISABLED       | The IIisServiceControl Interface is disabled.                                  |
	//	+--------------------------------------------+--------------------------------------------------------------------------------+
	Start(context.Context, *StartRequest) (*StartResponse, error)

	// This method is used to reboot the computer where the IIS service is running.
	//
	// The server implementation MAY<6> not implement this function. If it does not, then
	// it MUST return E_NOTIMPL.
	//
	// Return Values: A signed, 32-bit value indicating return status. If the method returns
	// a negative value, it has failed. If the 12-bit facility code (bits 16–27) is set
	// to 0x007, the value contains a Win32 error code in the lower 16 bits. 0 or positive
	// values indicate success, with the lower 16 bits in positive nonzero values containing
	// warnings or flags defined in the method implementation. For more information about
	// HRESULT, see [MS-ERREF] section 2.1.
	//
	// The method MUST return S_OK (0x00000000) upon success.
	//
	//	+--------------------------------------+----------------------------------------------------------------+
	//	|                RETURN                |                                                                |
	//	|              VALUE/CODE              |                          DESCRIPTION                           |
	//	|                                      |                                                                |
	//	+--------------------------------------+----------------------------------------------------------------+
	//	+--------------------------------------+----------------------------------------------------------------+
	//	| 0x00000000 S_OK                      | The call was successful.                                       |
	//	+--------------------------------------+----------------------------------------------------------------+
	//	| 0x80070008 E_ERROR_NOT_ENOUGH_MEMORY | Not enough memory is available to process this command.        |
	//	+--------------------------------------+----------------------------------------------------------------+
	//	| 0x800710D5 E_ERROR_RESOURCE_DISABLED | The IIisServiceControl interface is disabled.                  |
	//	+--------------------------------------+----------------------------------------------------------------+
	//	| 0x80004001 E_NOTIMPL                 | This function is not supported for this version of the server. |
	//	+--------------------------------------+----------------------------------------------------------------+
	Reboot(context.Context, *RebootRequest) (*RebootResponse, error)

	// This method returns the status of the Internet services.
	//
	// The server can have all functionality through this interface disabled using actions
	// taken local to the server machine. In this case the function MUST return an error
	// when called (E_ERROR_RESOURCE_DISABLED) and MUST NOT perform any other action.
	//
	// If the interface functionality is not disabled, the following SHOULD take place on
	// the server when this method is called:
	//
	// * The method SHOULD return a buffer of unsigned chars as described in section 2.2.2
	// ( 096ffe89-76be-4d01-9e4d-f68428a231fc ). This buffer of unsigned chars MUST contain
	// data about the status of the Internet services.
	//
	// * If it is not possible to return all the data in the buffer provided, then the following
	// conditional behavior MUST occur.
	//
	// For more information about the unsigned char buffer returned, see section 2.2.2.
	//
	// Return Values: A signed, 32-bit value indicating return status. If the method returns
	// a negative value, it has failed. If the 12-bit facility code (bits 16–27) is set
	// to 0x007, the value contains a Win32 error code in the lower 16 bits. 0 or positive
	// values indicate success, with the lower 16 bits in positive nonzero values containing
	// warnings or flags defined in the method implementation. For more information about
	// HRESULT, see [MS-ERREF] section 2.1.
	//
	// The method MUST return S_OK (0x00000000) upon success.
	//
	//	+----------------------------------------+----------------------------------------------------------------------------------+
	//	|                 RETURN                 |                                                                                  |
	//	|               VALUE/CODE               |                                   DESCRIPTION                                    |
	//	|                                        |                                                                                  |
	//	+----------------------------------------+----------------------------------------------------------------------------------+
	//	+----------------------------------------+----------------------------------------------------------------------------------+
	//	| 0x00000000 S_OK                        | The call was successful.                                                         |
	//	+----------------------------------------+----------------------------------------------------------------------------------+
	//	| 0x8007007A E_ERROR_INSUFFICIENT_BUFFER | The size of the pbBuffer is too small to return the status data based on its     |
	//	|                                        | size being declared in dwBufferSize parameter.                                   |
	//	+----------------------------------------+----------------------------------------------------------------------------------+
	//	| 0x80070008 E_ERROR_NOT_ENOUGH_MEMORY   | Not enough memory is available to process this command.                          |
	//	+----------------------------------------+----------------------------------------------------------------------------------+
	//	| 0x800710D5 E_ERROR_RESOURCE_DISABLED   | The IIisServiceControl interface is disabled.                                    |
	//	+----------------------------------------+----------------------------------------------------------------------------------+
	Status(context.Context, *StatusRequest) (*StatusResponse, error)

	// This method is used to terminate the Internet services processes. This erases the
	// IIS processes from memory, and is used to recover from failed instances of IIS processes.
	//
	// The server can have all functionality through this interface disabled using actions
	// taken local to the server machine. In this case the function MUST return an error
	// when called (E_ERROR_RESOURCE_DISABLED) and MUST NOT perform any other action.
	//
	// If the interface functionality is not disabled, the following SHOULD take place on
	// the server when this method is called:
	//
	// * The method SHOULD terminate all processes involved in supporting the Internet services
	// on the server.
	//
	// How the processes are terminated is implementation-dependent.<7>
	//
	// This method has no parameters.
	//
	// Return Values: A signed, 32-bit value indicating return status. If the method returns
	// a negative value, it has failed. If the 12-bit facility code (bits 16–27) is set
	// to 0x007, the value contains a Win32 error code in the lower 16 bits. 0 or positive
	// values indicate success, with the lower 16 bits in positive nonzero values containing
	// warnings or flags defined in the method implementation. For more information about
	// HRESULT, see [MS-ERREF] section 2.1.
	//
	// Each of the values that follow where the first byte contains 0x8007 is the HRESULT
	// derived from the Win32 error code with the specified name.
	//
	// The method MUST return S_OK (0x00000000) upon success.
	//
	//	+--------------------------------------+---------------------------------------------------------+
	//	|                RETURN                |                                                         |
	//	|              VALUE/CODE              |                       DESCRIPTION                       |
	//	|                                      |                                                         |
	//	+--------------------------------------+---------------------------------------------------------+
	//	+--------------------------------------+---------------------------------------------------------+
	//	| 0x00000000 S_OK                      | The call was successful.                                |
	//	+--------------------------------------+---------------------------------------------------------+
	//	| 0x80070008 E_ERROR_NOT_ENOUGH_MEMORY | Not enough memory is available to process this command. |
	//	+--------------------------------------+---------------------------------------------------------+
	//	| 0x800710D5 E_ERROR_RESOURCE_DISABLED | The IIisServiceControl interface is disabled.           |
	//	+--------------------------------------+---------------------------------------------------------+
	Kill(context.Context, *KillRequest) (*KillResponse, error)
}

IIisServiceControl server interface.

type KillRequest 

type KillRequest struct {
	// This: ORPCTHIS structure that is used to send ORPC extension data to the server.
	This *dcom.ORPCThis `idl:"name:This" json:"this"`
}

KillRequest structure represents the Kill operation request

func (*KillRequest) MarshalNDR 

func (o *KillRequest) MarshalNDR(ctx context.Context, w ndr.Writer) error

func (*KillRequest) UnmarshalNDR 

func (o *KillRequest) UnmarshalNDR(ctx context.Context, r ndr.Reader) error

type KillResponse 

type KillResponse struct {
	// That: ORPCTHAT structure that is used to return ORPC extension data to the client.
	That *dcom.ORPCThat `idl:"name:That" json:"that"`
	// Return: The Kill return value.
	Return int32 `idl:"name:Return" json:"return"`
}

KillResponse structure represents the Kill operation response

func (*KillResponse) MarshalNDR 

func (o *KillResponse) MarshalNDR(ctx context.Context, w ndr.Writer) error

func (*KillResponse) UnmarshalNDR 

func (o *KillResponse) UnmarshalNDR(ctx context.Context, r ndr.Reader) error

type RebootRequest 

type RebootRequest struct {
	// This: ORPCTHIS structure that is used to send ORPC extension data to the server.
	This         *dcom.ORPCThis `idl:"name:This" json:"this"`
	TimeoutMsecs uint32         `idl:"name:dwTimeouMsecs" json:"timeout_msecs"`
	// dwForceAppsClosed: Boolean value that specifies whether applications will be forced
	// to close.
	//
	//	+------------------+-------------------------------------------+
	//	|                  |                                           |
	//	|      VALUE       |                  MEANING                  |
	//	|                  |                                           |
	//	+------------------+-------------------------------------------+
	//	+------------------+-------------------------------------------+
	//	| TRUE 0x00000001  | Applications MUST be forced to close.     |
	//	+------------------+-------------------------------------------+
	//	| FALSE 0x00000000 | Applications MUST NOT be forced to close. |
	//	+------------------+-------------------------------------------+
	ForceAppsClosed uint32 `idl:"name:dwForceAppsClosed" json:"force_apps_closed"`
}

RebootRequest structure represents the Reboot operation request

func (*RebootRequest) MarshalNDR 

func (o *RebootRequest) MarshalNDR(ctx context.Context, w ndr.Writer) error

func (*RebootRequest) UnmarshalNDR 

func (o *RebootRequest) UnmarshalNDR(ctx context.Context, r ndr.Reader) error

type RebootResponse 

type RebootResponse struct {
	// That: ORPCTHAT structure that is used to return ORPC extension data to the client.
	That *dcom.ORPCThat `idl:"name:That" json:"that"`
	// Return: The Reboot return value.
	Return int32 `idl:"name:Return" json:"return"`
}

RebootResponse structure represents the Reboot operation response

func (*RebootResponse) MarshalNDR 

func (o *RebootResponse) MarshalNDR(ctx context.Context, w ndr.Writer) error

func (*RebootResponse) UnmarshalNDR 

func (o *RebootResponse) UnmarshalNDR(ctx context.Context, r ndr.Reader) error

type StartRequest 

type StartRequest struct {
	// This: ORPCTHIS structure that is used to send ORPC extension data to the server.
	This *dcom.ORPCThis `idl:"name:This" json:"this"`
	// dwTimeoutMsecs: Length of time, in milliseconds, allowed to start the services. After
	// this time has passed, the server MUST return 0x8000041D (E_ERROR_SERVICE_REQUEST_TIMEOUT).
	TimeoutMsecs uint32 `idl:"name:dwTimeoutMsecs" json:"timeout_msecs"`
}

StartRequest structure represents the Start operation request

func (*StartRequest) MarshalNDR 

func (o *StartRequest) MarshalNDR(ctx context.Context, w ndr.Writer) error

func (*StartRequest) UnmarshalNDR 

func (o *StartRequest) UnmarshalNDR(ctx context.Context, r ndr.Reader) error

type StartResponse 

type StartResponse struct {
	// That: ORPCTHAT structure that is used to return ORPC extension data to the client.
	That *dcom.ORPCThat `idl:"name:That" json:"that"`
	// Return: The Start return value.
	Return int32 `idl:"name:Return" json:"return"`
}

StartResponse structure represents the Start operation response

func (*StartResponse) MarshalNDR 

func (o *StartResponse) MarshalNDR(ctx context.Context, w ndr.Writer) error

func (*StartResponse) UnmarshalNDR 

func (o *StartResponse) UnmarshalNDR(ctx context.Context, r ndr.Reader) error

type StatusRequest 

type StatusRequest struct {
	// This: ORPCTHIS structure that is used to send ORPC extension data to the server.
	This *dcom.ORPCThis `idl:"name:This" json:"this"`
	// dwBufferSize: Size, in bytes, of the pbBuffer parameter. If this parameter is not
	// greater than the amount of data the server wants to return in pbBuffer, the conditional
	// behavior that follows MUST occur.
	//
	// * The pdwMDRequiredBufferSize parameter MUST be set to the number of bytes needed
	// to contain the data that is to be returned.
	//
	// * The pbBuffer parameter MUST be set to zero.
	//
	// * The method MUST be failed with code 0x8007007A (E_ERROR_INSUFFICIENT_BUFFER).
	BufferSize uint32 `idl:"name:dwBufferSize" json:"buffer_size"`
}

StatusRequest structure represents the Status operation request

func (*StatusRequest) MarshalNDR 

func (o *StatusRequest) MarshalNDR(ctx context.Context, w ndr.Writer) error

func (*StatusRequest) UnmarshalNDR 

func (o *StatusRequest) UnmarshalNDR(ctx context.Context, r ndr.Reader) error

type StatusResponse 

type StatusResponse struct {
	// That: ORPCTHAT structure that is used to return ORPC extension data to the client.
	That *dcom.ORPCThat `idl:"name:That" json:"that"`
	// pbBuffer: An array of unsigned chars that will be filled with information about the
	// status of the Internet services. For more information, see section 2.2.2.
	Buffer []byte `idl:"name:pbBuffer;size_is:(dwBufferSize)" json:"buffer"`
	// pdwMDRequiredBufferSize: On return from this method, if this parameter is not null,
	// this parameter points to a DWORD containing the number of bytes that pbBuffer must
	// be able to contain for the method to return the services status information. This
	// field MAY be used.
	RequiredBufferSize uint32 `idl:"name:pdwMDRequiredBufferSize" json:"required_buffer_size"`
	// pdwNumServices: The number of services for which status is returned.
	ServicesLength uint32 `idl:"name:pdwNumServices" json:"services_length"`
	// Return: The Status return value.
	Return int32 `idl:"name:Return" json:"return"`
}

StatusResponse structure represents the Status operation response

func (*StatusResponse) MarshalNDR 

func (o *StatusResponse) MarshalNDR(ctx context.Context, w ndr.Writer) error

func (*StatusResponse) UnmarshalNDR 

func (o *StatusResponse) UnmarshalNDR(ctx context.Context, r ndr.Reader) error

type StopRequest 

type StopRequest struct {
	// This: ORPCTHIS structure that is used to send ORPC extension data to the server.
	This *dcom.ORPCThis `idl:"name:This" json:"this"`
	// dwTimeoutMsecs: Length of time allowed for services to stop. If this time has elapsed,
	// and not all services have stopped, then the conditional behavior that follows SHOULD
	// occur.
	TimeoutMsecs uint32 `idl:"name:dwTimeoutMsecs" json:"timeout_msecs"`
	// dwForce: Boolean value that specifies whether the services will be forced to terminate.
	// If the graceful stopping of any service fails, then the conditional behavior that
	// follows SHOULD occur.
	//
	//	+------------------+-------------------------------------------+
	//	|                  |                                           |
	//	|      VALUE       |                  MEANING                  |
	//	|                  |                                           |
	//	+------------------+-------------------------------------------+
	//	+------------------+-------------------------------------------+
	//	| TRUE 0x00000001  | Services MUST be forced to terminate.     |
	//	+------------------+-------------------------------------------+
	//	| FALSE 0x00000000 | Services MUST NOT be forced to terminate. |
	//	+------------------+-------------------------------------------+
	Force uint32 `idl:"name:dwForce" json:"force"`
}

StopRequest structure represents the Stop operation request

func (*StopRequest) MarshalNDR 

func (o *StopRequest) MarshalNDR(ctx context.Context, w ndr.Writer) error

func (*StopRequest) UnmarshalNDR 

func (o *StopRequest) UnmarshalNDR(ctx context.Context, r ndr.Reader) error

type StopResponse 

type StopResponse struct {
	// That: ORPCTHAT structure that is used to return ORPC extension data to the client.
	That *dcom.ORPCThat `idl:"name:That" json:"that"`
	// Return: The Stop return value.
	Return int32 `idl:"name:Return" json:"return"`
}

StopResponse structure represents the Stop operation response

func (*StopResponse) MarshalNDR 

func (o *StopResponse) MarshalNDR(ctx context.Context, w ndr.Writer) error

func (*StopResponse) UnmarshalNDR 

func (o *StopResponse) UnmarshalNDR(ctx context.Context, r ndr.Reader) error

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.