ireplicationutil

package
v1.0.0 Latest Latest
Warning

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

Go to latest
Published: Apr 30, 2024 License: MIT Imports: 11 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	// IReplicationUtil interface identifier 98315903-7be5-11d2-adc1-00a02463d6e7
	ReplicationUtilIID = &dcom.IID{Data1: 0x98315903, Data2: 0x7be5, Data3: 0x11d2, Data4: []byte{0xad, 0xc1, 0x00, 0xa0, 0x24, 0x63, 0xd6, 0xe7}}
	// Syntax UUID
	ReplicationUtilSyntaxUUID = &uuid.UUID{TimeLow: 0x98315903, TimeMid: 0x7be5, TimeHiAndVersion: 0x11d2, ClockSeqHiAndReserved: 0xad, ClockSeqLow: 0xc1, Node: [6]uint8{0x0, 0xa0, 0x24, 0x63, 0xd6, 0xe7}}
	// Syntax ID
	ReplicationUtilSyntaxV0_0 = &dcerpc.SyntaxID{IfUUID: ReplicationUtilSyntaxUUID, IfVersionMajor: 0, IfVersionMinor: 0}
)
View Source
var (
	// import guard
	GoPackage = "dcom/coma"
)

Functions

func NewReplicationUtilServerHandle

func NewReplicationUtilServerHandle(o ReplicationUtilServer) dcerpc.ServerHandle

func RegisterReplicationUtilServer

func RegisterReplicationUtilServer(conn dcerpc.Conn, o ReplicationUtilServer, opts ...dcerpc.Option)

func ReplicationUtilServerHandle

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

Types

type BeginReplicationAsTargetRequest

type BeginReplicationAsTargetRequest struct {
	// This: ORPCTHIS structure that is used to send ORPC extension data to the server.
	This *dcom.ORPCThis `idl:"name:This" json:"this"`
	// pwszBaseReplicationDir: The server's base replication directory path.
	BaseReplicationDir string `idl:"name:pwszBaseReplicationDir" json:"base_replication_dir"`
}

BeginReplicationAsTargetRequest structure represents the BeginReplicationAsTarget operation request

func (*BeginReplicationAsTargetRequest) MarshalNDR

func (*BeginReplicationAsTargetRequest) UnmarshalNDR

type BeginReplicationAsTargetResponse

type BeginReplicationAsTargetResponse 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 BeginReplicationAsTarget return value.
	Return int32 `idl:"name:Return" json:"return"`
}

BeginReplicationAsTargetResponse structure represents the BeginReplicationAsTarget operation response

func (*BeginReplicationAsTargetResponse) MarshalNDR

func (*BeginReplicationAsTargetResponse) UnmarshalNDR

type CreateEmptyDirRequest

type CreateEmptyDirRequest struct {
	// This: ORPCTHIS structure that is used to send ORPC extension data to the server.
	This *dcom.ORPCThis `idl:"name:This" json:"this"`
	// pwszPath: An ImplementationSpecificPathProperty (section 2.2.2.2) representing the
	// path to the directory that is to be created by the server. This MUST be derived from
	// the server’s base replication directory path by appending one of the following
	// strings.
	//
	//	+------------------+-------------------------------------+
	//	|                  |                                     |
	//	|      VALUE       |               MEANING               |
	//	|                  |                                     |
	//	+------------------+-------------------------------------+
	//	+------------------+-------------------------------------+
	//	| "\ReplicaSource" | The server is a replication source. |
	//	+------------------+-------------------------------------+
	//	| "\ReplicaNew"    | The server is a replication target. |
	//	+------------------+-------------------------------------+
	Path string `idl:"name:pwszPath" json:"path"`
}

CreateEmptyDirRequest structure represents the CreateEmptyDir operation request

func (*CreateEmptyDirRequest) MarshalNDR

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

func (*CreateEmptyDirRequest) UnmarshalNDR

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

type CreateEmptyDirResponse

type CreateEmptyDirResponse 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 CreateEmptyDir return value.
	Return int32 `idl:"name:Return" json:"return"`
}

CreateEmptyDirResponse structure represents the CreateEmptyDir operation response

func (*CreateEmptyDirResponse) MarshalNDR

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

func (*CreateEmptyDirResponse) UnmarshalNDR

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

type CreateReplicationDirRequest

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

CreateReplicationDirRequest structure represents the CreateReplicationDir operation request

func (*CreateReplicationDirRequest) MarshalNDR

func (*CreateReplicationDirRequest) UnmarshalNDR

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

type CreateReplicationDirResponse

type CreateReplicationDirResponse struct {
	// That: ORPCTHAT structure that is used to return ORPC extension data to the client.
	That *dcom.ORPCThat `idl:"name:That" json:"that"`
	// ppwszBaseReplicationDir: A pointer to a variable that, upon successful completion,
	// MUST contain the server's base replication directory path.
	BaseReplicationDir string `idl:"name:ppwszBaseReplicationDir" json:"base_replication_dir"`
	// Return: The CreateReplicationDir return value.
	Return int32 `idl:"name:Return" json:"return"`
}

CreateReplicationDirResponse structure represents the CreateReplicationDir operation response

func (*CreateReplicationDirResponse) MarshalNDR

func (*CreateReplicationDirResponse) UnmarshalNDR

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

type CreateShareRequest

type CreateShareRequest struct {
	// This: ORPCTHIS structure that is used to send ORPC extension data to the server.
	This *dcom.ORPCThis `idl:"name:This" json:"this"`
	// pwszShareName: The share name (as specified for a path in UNC syntax) of the file
	// share to create. This MUST be a SourceShareName or TargetNewShareName, according
	// to the following ABNF syntax, as specified in [RFC4234].
	//
	// SourceShareName = "ReplicaSource" CurlyBracedGuidString TargetNewShareName = "ReplicaTargetNew"
	// CurlyBracedGuidString
	//
	// Where CurlyBracedGuidString is in Curly Braced GUID String Syntax ([MS-DTYP] section
	// 2.3.4.3).
	//
	// These formats have the following usage.
	//
	//	+--------------------+-----------------------------------------------+
	//	|                    |                                               |
	//	|       FORMAT       |                     USAGE                     |
	//	|                    |                                               |
	//	+--------------------+-----------------------------------------------+
	//	+--------------------+-----------------------------------------------+
	//	| SourceShareName    | Used when the server is a replication source. |
	//	+--------------------+-----------------------------------------------+
	//	| TargetNewShareName | Used when the server is a replication target. |
	//	+--------------------+-----------------------------------------------+
	ShareName string `idl:"name:pwszShareName" json:"share_name"`
	// pwszPath: An ImplementationSpecificPathProperty (section 2.2.2.2) representing the
	// path to the directory that is to back the file share. This MUST be derived from the
	// server's base replication directory path by appending one of the following strings.
	//
	//	+------------------+-------------------------------------+
	//	|                  |                                     |
	//	|      VALUE       |               MEANING               |
	//	|                  |                                     |
	//	+------------------+-------------------------------------+
	//	+------------------+-------------------------------------+
	//	| "\ReplicaSource" | The server is a replication source. |
	//	+------------------+-------------------------------------+
	//	| "\ReplicaNew"    | The server is a replication target. |
	//	+------------------+-------------------------------------+
	Path string `idl:"name:pwszPath" json:"path"`
}

CreateShareRequest structure represents the CreateShare operation request

func (*CreateShareRequest) MarshalNDR

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

func (*CreateShareRequest) UnmarshalNDR

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

type CreateShareResponse

type CreateShareResponse 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 CreateShare return value.
	Return int32 `idl:"name:Return" json:"return"`
}

CreateShareResponse structure represents the CreateShare operation response

func (*CreateShareResponse) MarshalNDR

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

func (*CreateShareResponse) UnmarshalNDR

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

type QueryConglomerationPasswordRequest

type QueryConglomerationPasswordRequest struct {
	// This: ORPCTHIS structure that is used to send ORPC extension data to the server.
	This *dcom.ORPCThis `idl:"name:This" json:"this"`
	// ConglomerationId: The conglomeration identifier of the conglomeration whose Password
	// property is requested.
	ConglomerationID *dtyp.GUID `idl:"name:ConglomerationId" json:"conglomeration_id"`
}

QueryConglomerationPasswordRequest structure represents the QueryConglomerationPassword operation request

func (*QueryConglomerationPasswordRequest) MarshalNDR

func (*QueryConglomerationPasswordRequest) UnmarshalNDR

type QueryConglomerationPasswordResponse

type QueryConglomerationPasswordResponse struct {
	// That: ORPCTHAT structure that is used to return ORPC extension data to the client.
	That *dcom.ORPCThat `idl:"name:That" json:"that"`
	// ppvPassword: A pointer to a variable that, upon successful completion, MUST be set
	// to an array of bytes containing a null-terminated array of wchar_t in little-endian
	// byte order.
	Password []byte `idl:"name:ppvPassword;size_is:(, pcbPassword)" json:"password"`
	// pcbPassword: A pointer to a variable that, upon successful completion, MUST be set
	// to the length of ppvPassword.
	PasswordLength uint32 `idl:"name:pcbPassword" json:"password_length"`
	// Return: The QueryConglomerationPassword return value.
	Return int32 `idl:"name:Return" json:"return"`
}

QueryConglomerationPasswordResponse structure represents the QueryConglomerationPassword operation response

func (*QueryConglomerationPasswordResponse) MarshalNDR

func (*QueryConglomerationPasswordResponse) UnmarshalNDR

type RemoveShareRequest

type RemoveShareRequest struct {
	// This: ORPCTHIS structure that is used to send ORPC extension data to the server.
	This *dcom.ORPCThis `idl:"name:This" json:"this"`
	// pwszShareName: The share name (as specified for a path in UNC syntax) of the file
	// share to remove. This MUST be a SourceShareName, TargetNewShareName, or TargetCurrentShareName,
	// according to the following Augmented Backus-Naur Form (ABNF) syntax, as specified
	// in [RFC4234].
	//
	// SourceShareName = "ReplicaSource" CurlyBracedGuidString TargetNewShareName = "ReplicaTargetNew"
	// CurlyBracedGuidString TargetCurrentShareName = "ReplicaTargetCurrent"
	//
	// Where CurlyBracedGuidString is in Curly Braced GUID String Syntax ([MS-DTYP] section
	// 2.3.4.3).
	//
	// These formats have the following usage.
	//
	//	+------------------------+----------------------------------------------------------------------------------+
	//	|                        |                                                                                  |
	//	|         FORMAT         |                                      USAGE                                       |
	//	|                        |                                                                                  |
	//	+------------------------+----------------------------------------------------------------------------------+
	//	+------------------------+----------------------------------------------------------------------------------+
	//	| SourceShareName        | Used when the server is a replication source and the replication client          |
	//	|                        | application is finished copying files from the server.                           |
	//	+------------------------+----------------------------------------------------------------------------------+
	//	| TargetNewShareName     | Used when the server is a replication target and the replication client          |
	//	|                        | application is finished copying files to the server.                             |
	//	+------------------------+----------------------------------------------------------------------------------+
	//	| TargetCurrentShareName | Used when the server is a replication target and the replication client          |
	//	|                        | application is finished importing conglomerations from the share.                |
	//	+------------------------+----------------------------------------------------------------------------------+
	ShareName string `idl:"name:pwszShareName" json:"share_name"`
}

RemoveShareRequest structure represents the RemoveShare operation request

func (*RemoveShareRequest) MarshalNDR

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

func (*RemoveShareRequest) UnmarshalNDR

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

type RemoveShareResponse

type RemoveShareResponse 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 RemoveShare return value.
	Return int32 `idl:"name:Return" json:"return"`
}

RemoveShareResponse structure represents the RemoveShare operation response

func (*RemoveShareResponse) MarshalNDR

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

func (*RemoveShareResponse) UnmarshalNDR

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

type ReplicationUtilClient

type ReplicationUtilClient interface {

	// IUnknown retrieval method.
	Unknown() iunknown.UnknownClient

	// This method is called by a replication client application to create a Common Internet
	// File System (CIFS) [MS-CIFS] file share for copying installer package files.
	//
	// Return Values: This method MUST return S_OK (0x00000000) on success, and a failure
	// result, as specified in [MS-ERREF] section 2.1, on failure. All failure results MUST
	// be treated identically.
	CreateShare(context.Context, *CreateShareRequest, ...dcerpc.CallOption) (*CreateShareResponse, error)

	// This method is called by a replication client application to create an empty directory
	// to back up a replication file share.
	//
	// Return Values: This method MUST return S_OK (0x00000000) on success, and a failure
	// result, as specified in [MS-ERREF] section 2.1, on failure. All failure results MUST
	// be treated identically.
	CreateEmptyDir(context.Context, *CreateEmptyDirRequest, ...dcerpc.CallOption) (*CreateEmptyDirResponse, error)

	// This method is called by a replication client application to remove a file share
	// that was used during replication and is no longer needed.
	//
	// Return Values: This method MUST return S_OK (0x00000000) on success, and a failure
	// result, as specified in [MS-ERREF] section 2.1, on failure. All failure results MUST
	// be treated identically.
	RemoveShare(context.Context, *RemoveShareRequest, ...dcerpc.CallOption) (*RemoveShareResponse, error)

	// This method is called by a replication client application to request that a server
	// perform the actions necessary to begin a replication operation in which the server
	// is a replication target. This typically happens after the application has copied
	// import package files for the conglomerations to be copied to a replication target
	// file share on the server. As part of the handling of the method, the server sets
	// up a replication working directory and file share. The server's handling of the method
	// might also include management of replication history and backup state.
	//
	// Return Values: This method MUST return S_OK (0x00000000) on success, and a failure
	// result, as specified in [MS-ERREF] section 2.1, on failure. All failure results MUST
	// be treated identically.
	BeginReplicationAsTarget(context.Context, *BeginReplicationAsTargetRequest, ...dcerpc.CallOption) (*BeginReplicationAsTargetResponse, error)

	// This method is called by a replication client application to obtain the value of
	// the Password property of a conglomeration.
	//
	// Return Values: This method MUST return S_OK (0x00000000) on success, and a failure
	// result, as specified in [MS-ERREF] section 2.1, on failure. All failure results MUST
	// be treated identically.
	QueryConglomerationPassword(context.Context, *QueryConglomerationPasswordRequest, ...dcerpc.CallOption) (*QueryConglomerationPasswordResponse, error)

	// This method is called by a replication client application to ensure that the server's
	// base replication directory exists and to get its path.
	//
	// Return Values: This method MUST return S_OK (0x00000000) on success, and a failure
	// result, as specified in [MS-ERREF] section 2.1, on failure. All failure results MUST
	// be treated identically.
	CreateReplicationDir(context.Context, *CreateReplicationDirRequest, ...dcerpc.CallOption) (*CreateReplicationDirResponse, error)

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

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

IReplicationUtil interface.

func NewReplicationUtilClient

func NewReplicationUtilClient(ctx context.Context, cc dcerpc.Conn, opts ...dcerpc.Option) (ReplicationUtilClient, error)

type ReplicationUtilServer

type ReplicationUtilServer interface {

	// IUnknown base class.
	iunknown.UnknownServer

	// This method is called by a replication client application to create a Common Internet
	// File System (CIFS) [MS-CIFS] file share for copying installer package files.
	//
	// Return Values: This method MUST return S_OK (0x00000000) on success, and a failure
	// result, as specified in [MS-ERREF] section 2.1, on failure. All failure results MUST
	// be treated identically.
	CreateShare(context.Context, *CreateShareRequest) (*CreateShareResponse, error)

	// This method is called by a replication client application to create an empty directory
	// to back up a replication file share.
	//
	// Return Values: This method MUST return S_OK (0x00000000) on success, and a failure
	// result, as specified in [MS-ERREF] section 2.1, on failure. All failure results MUST
	// be treated identically.
	CreateEmptyDir(context.Context, *CreateEmptyDirRequest) (*CreateEmptyDirResponse, error)

	// This method is called by a replication client application to remove a file share
	// that was used during replication and is no longer needed.
	//
	// Return Values: This method MUST return S_OK (0x00000000) on success, and a failure
	// result, as specified in [MS-ERREF] section 2.1, on failure. All failure results MUST
	// be treated identically.
	RemoveShare(context.Context, *RemoveShareRequest) (*RemoveShareResponse, error)

	// This method is called by a replication client application to request that a server
	// perform the actions necessary to begin a replication operation in which the server
	// is a replication target. This typically happens after the application has copied
	// import package files for the conglomerations to be copied to a replication target
	// file share on the server. As part of the handling of the method, the server sets
	// up a replication working directory and file share. The server's handling of the method
	// might also include management of replication history and backup state.
	//
	// Return Values: This method MUST return S_OK (0x00000000) on success, and a failure
	// result, as specified in [MS-ERREF] section 2.1, on failure. All failure results MUST
	// be treated identically.
	BeginReplicationAsTarget(context.Context, *BeginReplicationAsTargetRequest) (*BeginReplicationAsTargetResponse, error)

	// This method is called by a replication client application to obtain the value of
	// the Password property of a conglomeration.
	//
	// Return Values: This method MUST return S_OK (0x00000000) on success, and a failure
	// result, as specified in [MS-ERREF] section 2.1, on failure. All failure results MUST
	// be treated identically.
	QueryConglomerationPassword(context.Context, *QueryConglomerationPasswordRequest) (*QueryConglomerationPasswordResponse, error)

	// This method is called by a replication client application to ensure that the server's
	// base replication directory exists and to get its path.
	//
	// Return Values: This method MUST return S_OK (0x00000000) on success, and a failure
	// result, as specified in [MS-ERREF] section 2.1, on failure. All failure results MUST
	// be treated identically.
	CreateReplicationDir(context.Context, *CreateReplicationDirRequest) (*CreateReplicationDirResponse, error)
}

IReplicationUtil server interface.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL