Service Control Functions

データ構造
struct	SvcOpenScm
struct	SvcEnumServices
struct	SvcOpenService
struct	SvcGetStatus
struct	SvcStartService
struct	SvcControlService
struct	SvcStopService
struct	SvcPauseService
struct	SvcContinueService
struct	SvcGetDisplayName
struct	SvcGetServiceConfig
関数
int	cac_SvcOpenScm (CacServerHandle *hnd, TALLOC_CTX *mem_ctx, struct SvcOpenScm *op)
	Opens a handle to the SCM on the remote machine.
int	cac_SvcClose (CacServerHandle *hnd, TALLOC_CTX *mem_ctx, POLICY_HND *scm_hnd)
	Closes an Svc handle (SCM or Service)
int	cac_SvcEnumServices (CacServerHandle *hnd, TALLOC_CTX *mem_ctx, struct SvcEnumServices *op)
	Enumerates services on the remote machine.
int	cac_SvcOpenService (CacServerHandle *hnd, TALLOC_CTX *mem_ctx, struct SvcOpenService *op)
	Opens a handle to a service.
int	cac_SvcGetStatus (CacServerHandle *hnd, TALLOC_CTX *mem_ctx, struct SvcGetStatus *op)
	Retrieves the status of a service.
int	cac_SvcStartService (CacServerHandle *hnd, TALLOC_CTX *mem_ctx, struct SvcStartService *op)
	Attempts to start a service.
int	cac_SvcControlService (CacServerHandle *hnd, TALLOC_CTX *mem_ctx, struct SvcControlService *op)
	Performs a control operation on a service and _immediately_ returns.
int	cac_SvcStopService (CacServerHandle *hnd, TALLOC_CTX *mem_ctx, struct SvcStopService *op)
	Attempts to stop a service.
int	cac_SvcPauseService (CacServerHandle *hnd, TALLOC_CTX *mem_ctx, struct SvcPauseService *op)
	Attempts to pause a service.
int	cac_SvcContinueService (CacServerHandle *hnd, TALLOC_CTX *mem_ctx, struct SvcContinueService *op)
	Attempts to continue a paused service.
int	cac_SvcGetDisplayName (CacServerHandle *hnd, TALLOC_CTX *mem_ctx, struct SvcGetDisplayName *op)
	Retrieves the display name of a service _not currently working_
int	cac_SvcGetServiceConfig (CacServerHandle *hnd, TALLOC_CTX *mem_ctx, struct SvcGetServiceConfig *op)
	Retrieves configuration information about a service.

---

関数

int cac_SvcOpenScm	(	CacServerHandle *	hnd,
		TALLOC_CTX *	mem_ctx,
		struct SvcOpenScm *	op
	)

Opens a handle to the SCM on the remote machine.

引数:

	hnd	Initialized and connected server handle
	mem_ctx	Context for memory allocation
	op	Initialized parameters

戻り値:

CAC_FAILURE - the operation was not successful hnd->status is set appropriately

CAC_SUCCESS - the operation was successful

cac_svcctl.c の 31 行で定義されています。

参照先 _CACSERVERHANDLE::_internal・SvcOpenScm::access・cac_GetServer()・_SMBCSRV::cli・cli_rpc_pipe_open_noauth()・CacServerHandleInternal::ctx・err・SvcOpenScm::in・SvcOpenScm::out・CacServerHandleInternal::pipes・rpccli_svcctl_open_scm()・SvcOpenScm::scm_hnd・_CACSERVERHANDLE::status・werror_to_ntstatus().

{
        SMBCSRV *srv = NULL;
        struct rpc_pipe_client *pipe_hnd = NULL;
        WERROR err;

        POLICY_HND *scm_out = NULL;

        if ( !hnd )
                return CAC_FAILURE;

        if ( !hnd->_internal.ctx ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        if ( !op || op->in.access == 0 || !mem_ctx ) {
                hnd->status = NT_STATUS_INVALID_PARAMETER;
                return CAC_FAILURE;
        }

        srv = cac_GetServer( hnd );
        if ( !srv ) {
                hnd->status = NT_STATUS_INVALID_CONNECTION;
                return CAC_FAILURE;
        }

        /*initialize for samr pipe if we have to */
        if ( !hnd->_internal.pipes[PI_SVCCTL] ) {
                if ( !
                     ( pipe_hnd =
                       cli_rpc_pipe_open_noauth( srv->cli, PI_SVCCTL,
                                                 &( hnd->status ) ) ) ) {
                        hnd->status = NT_STATUS_UNSUCCESSFUL;
                        return CAC_FAILURE;
                }

                hnd->_internal.pipes[PI_SVCCTL] = True;
        }

        scm_out = talloc( mem_ctx, POLICY_HND );
        if ( !scm_out ) {
                hnd->status = NT_STATUS_NO_MEMORY;
                return CAC_FAILURE;
        }

        err = rpccli_svcctl_open_scm( pipe_hnd, mem_ctx, scm_out,
                                      op->in.access );
        hnd->status = werror_to_ntstatus( err );

        if ( !NT_STATUS_IS_OK( hnd->status ) )
                return CAC_FAILURE;

        op->out.scm_hnd = scm_out;

        return CAC_SUCCESS;
}

int cac_SvcClose	(	CacServerHandle *	hnd,
		TALLOC_CTX *	mem_ctx,
		POLICY_HND *	scm_hnd
	)

Closes an Svc handle (SCM or Service)

引数:

	hnd	Initialized and connected server handle
	mem_ctx	Context for memory allocation
	scm_hnd	The handle to close

戻り値:

CAC_FAILURE - the operation was not successful hnd->status is set appropriately

CAC_SUCCESS - the operation was successful

cac_svcctl.c の 90 行で定義されています。

参照先 _CACSERVERHANDLE::_internal・cac_GetPipe()・CacServerHandleInternal::ctx・err・rpccli_svcctl_close_service()・_CACSERVERHANDLE::status・werror_to_ntstatus().

{
        struct rpc_pipe_client *pipe_hnd = NULL;
        WERROR err;

        if ( !hnd )
                return CAC_FAILURE;

        if ( !hnd->_internal.ctx ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        if ( !scm_hnd || !mem_ctx ) {
                hnd->status = NT_STATUS_INVALID_PARAMETER;
                return CAC_FAILURE;
        }

        pipe_hnd = cac_GetPipe( hnd, PI_SVCCTL );
        if ( !pipe_hnd ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        err = rpccli_svcctl_close_service( pipe_hnd, mem_ctx, scm_hnd );
        hnd->status = werror_to_ntstatus( err );

        if ( !NT_STATUS_IS_OK( hnd->status ) )
                return CAC_FAILURE;

        return CAC_SUCCESS;
}

int cac_SvcEnumServices	(	CacServerHandle *	hnd,
		TALLOC_CTX *	mem_ctx,
		struct SvcEnumServices *	op
	)

Enumerates services on the remote machine.

引数:

	hnd	Initialized and connected server handle
	mem_ctx	Context for memory allocation
	op	Initialized parameters

戻り値:

CAC_FAILURE - the operation was not successful hnd->status is set appropriately

CAC_SUCCESS - the operation was successful

cac_svcctl.c の 124 行で定義されています。

参照先 _CACSERVERHANDLE::_internal・cac_GetPipe()・cac_MakeServiceArray()・CacServerHandleInternal::ctx・err・SvcEnumServices::in・SvcEnumServices::num_services・SvcEnumServices::out・rpccli_svcctl_enumerate_services()・SvcEnumServices::scm_hnd・SvcEnumServices::services・SvcEnumServices::state・_CACSERVERHANDLE::status・SvcEnumServices::type・type・werror_to_ntstatus().

{
        struct rpc_pipe_client *pipe_hnd = NULL;
        WERROR err;

        uint32 type_buf = 0;
        uint32 state_buf = 0;

        uint32 num_svc_out = 0;

        ENUM_SERVICES_STATUS *svc_buf = NULL;

        if ( !hnd )
                return CAC_FAILURE;

        if ( !hnd->_internal.ctx ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        if ( !op || !op->in.scm_hnd || !mem_ctx ) {
                hnd->status = NT_STATUS_INVALID_PARAMETER;
                return CAC_FAILURE;
        }

        pipe_hnd = cac_GetPipe( hnd, PI_SVCCTL );
        if ( !pipe_hnd ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        type_buf =
                ( op->in.type !=
                  0 ) ? op->in.
                type : ( SVCCTL_TYPE_DRIVER | SVCCTL_TYPE_WIN32 );
        state_buf = ( op->in.state != 0 ) ? op->in.state : SVCCTL_STATE_ALL;

        err = rpccli_svcctl_enumerate_services( pipe_hnd, mem_ctx,
                                                op->in.scm_hnd, type_buf,
                                                state_buf, &num_svc_out,
                                                &svc_buf );
        hnd->status = werror_to_ntstatus( err );

        if ( !NT_STATUS_IS_OK( hnd->status ) )
                return CAC_FAILURE;

        op->out.services =
                cac_MakeServiceArray( mem_ctx, svc_buf, num_svc_out );

        if ( !op->out.services ) {
                hnd->status = NT_STATUS_NO_MEMORY;
                return CAC_FAILURE;
        }

        TALLOC_FREE( svc_buf );

        op->out.num_services = num_svc_out;

        return CAC_SUCCESS;
}

int cac_SvcOpenService	(	CacServerHandle *	hnd,
		TALLOC_CTX *	mem_ctx,
		struct SvcOpenService *	op
	)

Opens a handle to a service.

引数:

	hnd	Initialized and connected server handle
	mem_ctx	Context for memory allocation
	op	Initialized Parameters

戻り値:

CAC_FAILURE - the operation was not successful hnd->status is set appropriately

CAC_SUCCESS - the operation was successful

cac_svcctl.c の 186 行で定義されています。

参照先 _CACSERVERHANDLE::_internal・SvcOpenService::access・cac_GetPipe()・CacServerHandleInternal::ctx・err・SvcOpenService::in・SvcOpenService::name・SvcOpenService::out・rpccli_svcctl_open_service()・SvcOpenService::scm_hnd・_CACSERVERHANDLE::status・SvcOpenService::svc_hnd・werror_to_ntstatus().

{
        struct rpc_pipe_client *pipe_hnd = NULL;
        WERROR err;

        POLICY_HND *svc_hnd_out = NULL;

        if ( !hnd )
                return CAC_FAILURE;

        if ( !hnd->_internal.ctx ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        if ( !op || !op->in.scm_hnd || !op->in.name || !mem_ctx ) {
                hnd->status = NT_STATUS_INVALID_PARAMETER;
                return CAC_FAILURE;
        }

        pipe_hnd = cac_GetPipe( hnd, PI_SVCCTL );
        if ( !pipe_hnd ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        svc_hnd_out = talloc( mem_ctx, POLICY_HND );
        if ( !svc_hnd_out ) {
                hnd->status = NT_STATUS_NO_MEMORY;
                return CAC_FAILURE;
        }

        err = rpccli_svcctl_open_service( pipe_hnd, mem_ctx, op->in.scm_hnd,
                                          svc_hnd_out, op->in.name,
                                          op->in.access );
        hnd->status = werror_to_ntstatus( err );

        if ( !NT_STATUS_IS_OK( hnd->status ) )
                return CAC_FAILURE;

        op->out.svc_hnd = svc_hnd_out;

        return CAC_SUCCESS;
}

int cac_SvcGetStatus	(	CacServerHandle *	hnd,
		TALLOC_CTX *	mem_ctx,
		struct SvcGetStatus *	op
	)

Retrieves the status of a service.

引数:

	hnd	Initialized and connected server handle
	mem_ctx	Context for memory allocation
	op	Initialized Parameters

戻り値:

CAC_FAILURE - the operation was not successful hnd->status is set appropriately

CAC_SUCCESS - the operation was successful

cac_svcctl.c の 276 行で定義されています。

参照先 _CACSERVERHANDLE::_internal・cac_GetPipe()・CacServerHandleInternal::ctx・err・SvcGetStatus::in・SvcGetStatus::out・rpccli_svcctl_query_status()・_CACSERVERHANDLE::status・SvcGetStatus::status・SvcGetStatus::svc_hnd・werror_to_ntstatus().

{
        struct rpc_pipe_client *pipe_hnd = NULL;
        WERROR err;

        SERVICE_STATUS status_out;

        if ( !hnd )
                return CAC_FAILURE;

        if ( !hnd->_internal.ctx ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        if ( !op || !op->in.svc_hnd || !mem_ctx ) {
                hnd->status = NT_STATUS_INVALID_PARAMETER;
                return CAC_FAILURE;
        }

        pipe_hnd = cac_GetPipe( hnd, PI_SVCCTL );
        if ( !pipe_hnd ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        err = rpccli_svcctl_query_status( pipe_hnd, mem_ctx, op->in.svc_hnd,
                                          &status_out );
        hnd->status = werror_to_ntstatus( err );

        if ( !NT_STATUS_IS_OK( hnd->status ) )
                return CAC_FAILURE;

        op->out.status = status_out;

        return CAC_SUCCESS;
}

int cac_SvcStartService	(	CacServerHandle *	hnd,
		TALLOC_CTX *	mem_ctx,
		struct SvcStartService *	op
	)

Attempts to start a service.

引数:

	hnd	Initialized and connected server handle
	mem_ctx	Context for memory allocation
	op	Initialized Parameters

戻り値:

CAC_FAILURE - the operation was not successful hnd->status is set appropriately

CAC_SUCCESS - the operation was successful

cac_svcctl.c の 361 行で定義されています。

参照先 _CACSERVERHANDLE::_internal・cac_GetPipe()・cac_WaitForService()・CacServerHandleInternal::ctx・err・SvcStartService::in・SvcStartService::num_parms・SvcStartService::parms・rpccli_svcctl_start_service()・_CACSERVERHANDLE::status・SvcStartService::svc_hnd・SvcStartService::timeout・werror_to_ntstatus().

{
        struct rpc_pipe_client *pipe_hnd = NULL;
        WERROR err;

        SERVICE_STATUS status_buf;

        if ( !hnd )
                return CAC_FAILURE;

        if ( !hnd->_internal.ctx ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        if ( !op || !op->in.svc_hnd || !mem_ctx ) {
                hnd->status = NT_STATUS_INVALID_PARAMETER;
                return CAC_FAILURE;
        }

        if ( op->in.num_parms != 0 && op->in.parms == NULL ) {
                hnd->status = NT_STATUS_INVALID_PARAMETER;
                return CAC_FAILURE;
        }

        pipe_hnd = cac_GetPipe( hnd, PI_SVCCTL );
        if ( !pipe_hnd ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        err = rpccli_svcctl_start_service( pipe_hnd, mem_ctx, op->in.svc_hnd,
                                           ( const char ** ) op->in.parms,
                                           op->in.num_parms );
        hnd->status = werror_to_ntstatus( err );

        if ( !NT_STATUS_IS_OK( hnd->status ) )
                return CAC_FAILURE;

        if ( op->in.timeout == 0 )
                return CAC_SUCCESS;

        return cac_WaitForService( hnd, mem_ctx, op->in.svc_hnd,
                                   SVCCTL_RUNNING, op->in.timeout,
                                   &status_buf );
}

int cac_SvcControlService	(	CacServerHandle *	hnd,
		TALLOC_CTX *	mem_ctx,
		struct SvcControlService *	op
	)

Performs a control operation on a service and _immediately_ returns.

参照:

cac_SvcStopService()

cac_SvcPauseService()

cac_SvcContinueService()

cac_SvcShutdownService()

引数:

	hnd	Initialized and connected server handle
	mem_ctx	Context for memory allocation
	op	Initialized Parameters

戻り値:

CAC_FAILURE - the operation was not successful hnd->status is set appropriately

CAC_SUCCESS - the operation was successful

cac_svcctl.c の 232 行で定義されています。

参照先 _CACSERVERHANDLE::_internal・cac_GetPipe()・SvcControlService::control・CacServerHandleInternal::ctx・err・SvcControlService::in・rpccli_svcctl_control_service()・_CACSERVERHANDLE::status・SvcControlService::svc_hnd・werror_to_ntstatus().

{
        struct rpc_pipe_client *pipe_hnd = NULL;
        WERROR err;

        SERVICE_STATUS status_out;

        if ( !hnd )
                return CAC_FAILURE;

        if ( !hnd->_internal.ctx ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        if ( !op || !op->in.svc_hnd || !mem_ctx ) {
                hnd->status = NT_STATUS_INVALID_PARAMETER;
                return CAC_FAILURE;
        }

        if ( op->in.control < SVCCTL_CONTROL_STOP
             || op->in.control > SVCCTL_CONTROL_SHUTDOWN ) {
                hnd->status = NT_STATUS_INVALID_PARAMETER;
                return CAC_FAILURE;
        }

        pipe_hnd = cac_GetPipe( hnd, PI_SVCCTL );
        if ( !pipe_hnd ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        err = rpccli_svcctl_control_service( pipe_hnd, mem_ctx,
                                             op->in.svc_hnd, op->in.control,
                                             &status_out );
        hnd->status = werror_to_ntstatus( err );

        if ( !NT_STATUS_IS_OK( hnd->status ) )
                return CAC_FAILURE;

        return CAC_SUCCESS;
}

int cac_SvcStopService	(	CacServerHandle *	hnd,
		TALLOC_CTX *	mem_ctx,
		struct SvcStopService *	op
	)

Attempts to stop a service.

参照:

cacSvcControlService()

引数:

	hnd	Initialized and connected server handle
	mem_ctx	Context for memory allocation
	op	Initialized Parameters

戻り値:

CAC_FAILURE - the operation was not successful. If hnd->status is NT_STATUS_OK, then a timeout occured.

CAC_SUCCESS - the operation was successful

cac_svcctl.c の 409 行で定義されています。

参照先 _CACSERVERHANDLE::_internal・cac_GetPipe()・cac_WaitForService()・CacServerHandleInternal::ctx・err・SvcStopService::in・SvcStopService::out・rpccli_svcctl_control_service()・_CACSERVERHANDLE::status・SvcStopService::status・SvcStopService::svc_hnd・SvcStopService::timeout・werror_to_ntstatus().

{
        struct rpc_pipe_client *pipe_hnd = NULL;
        WERROR err;

        SERVICE_STATUS status_out;

        if ( !hnd )
                return CAC_FAILURE;

        if ( !hnd->_internal.ctx ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        if ( !op || !op->in.svc_hnd || !mem_ctx ) {
                hnd->status = NT_STATUS_INVALID_PARAMETER;
                return CAC_FAILURE;
        }

        pipe_hnd = cac_GetPipe( hnd, PI_SVCCTL );
        if ( !pipe_hnd ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        err = rpccli_svcctl_control_service( pipe_hnd, mem_ctx,
                                             op->in.svc_hnd,
                                             SVCCTL_CONTROL_STOP,
                                             &status_out );
        hnd->status = werror_to_ntstatus( err );

        if ( !NT_STATUS_IS_OK( hnd->status ) )
                return CAC_FAILURE;

        op->out.status = status_out;

        if ( op->in.timeout == 0 )
                return CAC_SUCCESS;

        return cac_WaitForService( hnd, mem_ctx, op->in.svc_hnd,
                                   SVCCTL_STOPPED, op->in.timeout,
                                   &op->out.status );
}

int cac_SvcPauseService	(	CacServerHandle *	hnd,
		TALLOC_CTX *	mem_ctx,
		struct SvcPauseService *	op
	)

Attempts to pause a service.

参照:

cacSvcControlService()

引数:

	hnd	Initialized and connected server handle
	mem_ctx	Context for memory allocation
	op	Initialized Parameters

戻り値:

CAC_FAILURE - the operation was not successful. If hnd->status is NT_STATUS_OK, then a timeout occured.

CAC_SUCCESS - the operation was successful

cac_svcctl.c の 455 行で定義されています。

参照先 _CACSERVERHANDLE::_internal・cac_GetPipe()・cac_WaitForService()・CacServerHandleInternal::ctx・err・SvcPauseService::in・SvcPauseService::out・rpccli_svcctl_control_service()・_CACSERVERHANDLE::status・SvcPauseService::status・SvcPauseService::svc_hnd・SvcPauseService::timeout・werror_to_ntstatus().

{
        struct rpc_pipe_client *pipe_hnd = NULL;
        WERROR err;

        SERVICE_STATUS status_out;

        if ( !hnd )
                return CAC_FAILURE;

        if ( !hnd->_internal.ctx ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        if ( !op || !op->in.svc_hnd || !mem_ctx ) {
                hnd->status = NT_STATUS_INVALID_PARAMETER;
                return CAC_FAILURE;
        }

        pipe_hnd = cac_GetPipe( hnd, PI_SVCCTL );
        if ( !pipe_hnd ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        err = rpccli_svcctl_control_service( pipe_hnd, mem_ctx,
                                             op->in.svc_hnd,
                                             SVCCTL_CONTROL_PAUSE,
                                             &status_out );
        hnd->status = werror_to_ntstatus( err );

        if ( !NT_STATUS_IS_OK( hnd->status ) )
                return CAC_FAILURE;

        op->out.status = status_out;

        if ( op->in.timeout == 0 )
                return CAC_SUCCESS;

        return cac_WaitForService( hnd, mem_ctx, op->in.svc_hnd,
                                   SVCCTL_PAUSED, op->in.timeout,
                                   &op->out.status );
}

int cac_SvcContinueService	(	CacServerHandle *	hnd,
		TALLOC_CTX *	mem_ctx,
		struct SvcContinueService *	op
	)

Attempts to continue a paused service.

参照:

cacSvcControlService()

引数:

	hnd	Initialized and connected server handle
	mem_ctx	Context for memory allocation
	op	Initialized Parameters

戻り値:

CAC_FAILURE - the operation was not successful. If hnd->status is NT_STATUS_OK, then a timeout occured.

CAC_SUCCESS - the operation was successful

cac_svcctl.c の 501 行で定義されています。

参照先 _CACSERVERHANDLE::_internal・cac_GetPipe()・cac_WaitForService()・CacServerHandleInternal::ctx・err・SvcContinueService::in・SvcContinueService::out・rpccli_svcctl_control_service()・_CACSERVERHANDLE::status・SvcContinueService::status・SvcContinueService::svc_hnd・SvcContinueService::timeout・werror_to_ntstatus().

{
        struct rpc_pipe_client *pipe_hnd = NULL;
        WERROR err;

        SERVICE_STATUS status_out;

        if ( !hnd )
                return CAC_FAILURE;

        if ( !hnd->_internal.ctx ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        if ( !op || !op->in.svc_hnd || !mem_ctx ) {
                hnd->status = NT_STATUS_INVALID_PARAMETER;
                return CAC_FAILURE;
        }

        pipe_hnd = cac_GetPipe( hnd, PI_SVCCTL );
        if ( !pipe_hnd ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        err = rpccli_svcctl_control_service( pipe_hnd, mem_ctx,
                                             op->in.svc_hnd,
                                             SVCCTL_CONTROL_CONTINUE,
                                             &status_out );
        hnd->status = werror_to_ntstatus( err );

        if ( !NT_STATUS_IS_OK( hnd->status ) )
                return CAC_FAILURE;

        op->out.status = status_out;

        if ( op->in.timeout == 0 )
                return CAC_SUCCESS;

        return cac_WaitForService( hnd, mem_ctx, op->in.svc_hnd,
                                   SVCCTL_RUNNING, op->in.timeout,
                                   &op->out.status );
}

int cac_SvcGetDisplayName	(	CacServerHandle *	hnd,
		TALLOC_CTX *	mem_ctx,
		struct SvcGetDisplayName *	op
	)

Retrieves the display name of a service _not currently working_

引数:

	hnd	Initialized and connected server handle
	mem_ctx	Context for memory allocation
	op	Initialized Parameters

戻り値:

CAC_FAILURE - the operation was not successful hnd->status is set appropriately

CAC_SUCCESS - the operation was successful

cac_svcctl.c の 547 行で定義されています。

参照先 _CACSERVERHANDLE::_internal・cac_GetPipe()・CacServerHandleInternal::ctx・SvcGetDisplayName::display_name・err・SvcGetDisplayName::in・SvcGetDisplayName::out・rpccli_svcctl_get_dispname()・_CACSERVERHANDLE::status・SvcGetDisplayName::svc_hnd・talloc_strdup()・werror_to_ntstatus().

{
        struct rpc_pipe_client *pipe_hnd = NULL;
        WERROR err;

        fstring disp_name_out;

        if ( !hnd )
                return CAC_FAILURE;

        if ( !hnd->_internal.ctx ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        if ( !op || !op->in.svc_hnd || !mem_ctx ) {
                hnd->status = NT_STATUS_INVALID_PARAMETER;
                return CAC_FAILURE;
        }

        pipe_hnd = cac_GetPipe( hnd, PI_SVCCTL );
        if ( !pipe_hnd ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        err = rpccli_svcctl_get_dispname( pipe_hnd, mem_ctx, op->in.svc_hnd,
                                          disp_name_out );
        hnd->status = werror_to_ntstatus( err );

        if ( !NT_STATUS_IS_OK( hnd->status ) )
                return CAC_FAILURE;

        op->out.display_name = talloc_strdup( mem_ctx, disp_name_out );

        if ( !op->out.display_name ) {
                hnd->status = NT_STATUS_NO_MEMORY;
                return CAC_FAILURE;
        }

        return CAC_SUCCESS;
}

int cac_SvcGetServiceConfig	(	CacServerHandle *	hnd,
		TALLOC_CTX *	mem_ctx,
		struct SvcGetServiceConfig *	op
	)

Retrieves configuration information about a service.

引数:

	hnd	Initialized and connected server handle
	mem_ctx	Context for memory allocation
	op	Initialized Parameters

戻り値:

CAC_FAILURE - the operation was not successful hnd->status is set appropriately

CAC_SUCCESS - the operation was successful

cac_svcctl.c の 592 行で定義されています。

参照先 _CACSERVERHANDLE::_internal・cac_GetPipe()・cac_InitCacServiceConfig()・SvcGetServiceConfig::config・CacServerHandleInternal::ctx・err・SvcGetServiceConfig::in・SvcGetServiceConfig::out・rpccli_svcctl_query_config()・_CACSERVERHANDLE::status・SvcGetServiceConfig::svc_hnd・werror_to_ntstatus().

{
        struct rpc_pipe_client *pipe_hnd = NULL;
        WERROR err;

        SERVICE_CONFIG config_out;

        if ( !hnd )
                return CAC_FAILURE;

        if ( !hnd->_internal.ctx ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        if ( !op || !op->in.svc_hnd || !mem_ctx ) {
                hnd->status = NT_STATUS_INVALID_PARAMETER;
                return CAC_FAILURE;
        }

        pipe_hnd = cac_GetPipe( hnd, PI_SVCCTL );
        if ( !pipe_hnd ) {
                hnd->status = NT_STATUS_INVALID_HANDLE;
                return CAC_FAILURE;
        }

        err = rpccli_svcctl_query_config( pipe_hnd, mem_ctx, op->in.svc_hnd,
                                          &config_out );
        hnd->status = werror_to_ntstatus( err );

        if ( !NT_STATUS_IS_OK( hnd->status ) )
                return CAC_FAILURE;

        if ( !cac_InitCacServiceConfig
             ( mem_ctx, &config_out, &op->out.config ) ) {
                hnd->status = NT_STATUS_NO_MEMORY;
                return CAC_FAILURE;
        }

        return CAC_SUCCESS;

}

---