Documentation
¶
Index ¶
- Variables
- func ImportServerHandle(ctx context.Context, o ImportServer, opNum int, r ndr.Reader) (dcerpc.Operation, error)
- func NewImportServerHandle(o ImportServer) dcerpc.ServerHandle
- func RegisterImportServer(conn dcerpc.Conn, o ImportServer, opts ...dcerpc.Option)
- type ImportClient
- type ImportFromFileRequest
- type ImportFromFileResponse
- type ImportServer
- type QueryFileRequest
- type QueryFileResponse
Constants ¶
This section is empty.
Variables ¶
View Source
var ( // IImport interface identifier c2be6970-df9e-11d1-8b87-00c04fd7a924 ImportIID = &dcom.IID{Data1: 0xc2be6970, Data2: 0xdf9e, Data3: 0x11d1, Data4: []byte{0x8b, 0x87, 0x00, 0xc0, 0x4f, 0xd7, 0xa9, 0x24}} // Syntax UUID ImportSyntaxUUID = &uuid.UUID{TimeLow: 0xc2be6970, TimeMid: 0xdf9e, TimeHiAndVersion: 0x11d1, ClockSeqHiAndReserved: 0x8b, ClockSeqLow: 0x87, Node: [6]uint8{0x0, 0xc0, 0x4f, 0xd7, 0xa9, 0x24}} // Syntax ID ImportSyntaxV0_0 = &dcerpc.SyntaxID{IfUUID: ImportSyntaxUUID, IfVersionMajor: 0, IfVersionMinor: 0} )
View Source
var (
// import guard
GoPackage = "dcom/coma"
)
Functions ¶
func ImportServerHandle ¶
func NewImportServerHandle ¶
func NewImportServerHandle(o ImportServer) dcerpc.ServerHandle
func RegisterImportServer ¶
func RegisterImportServer(conn dcerpc.Conn, o ImportServer, opts ...dcerpc.Option)
Types ¶
type ImportClient ¶
type ImportClient interface {
// IUnknown retrieval method.
Unknown() iunknown.UnknownClient
// This method is called by a client to import one or more conglomerations from an installer
// package file. Importing a conglomeration from an installer package file conceptually
// consists of installation of modules, including the registration of the components
// in those modules, and creating a conglomeration and component configurations equivalent
// to the conglomeration and the component configurations that were exported to create
// the installer package file. As a side effect, this method returns implementation-specific
// detailed results of the registration operation for informational purposes.
//
// 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.
//
// +-------------------+--------------------------+
// | RETURN | |
// | VALUE/CODE | DESCRIPTION |
// | | |
// +-------------------+--------------------------+
// +-------------------+--------------------------+
// | 0x00000000 S_OK | The call was successful. |
// +-------------------+--------------------------+
ImportFromFile(context.Context, *ImportFromFileRequest, ...dcerpc.CallOption) (*ImportFromFileResponse, error)
// This method is called by a client to retrieve information about an installer package
// file.
//
// 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.
//
// +-------------------+--------------------------+
// | RETURN | |
// | VALUE/CODE | DESCRIPTION |
// | | |
// +-------------------+--------------------------+
// +-------------------+--------------------------+
// | 0x00000000 S_OK | The call was successful. |
// +-------------------+--------------------------+
QueryFile(context.Context, *QueryFileRequest, ...dcerpc.CallOption) (*QueryFileResponse, error)
// AlterContext alters the client context.
AlterContext(context.Context, ...dcerpc.Option) error
// IPID sets the object interface identifier.
IPID(context.Context, *dcom.IPID) ImportClient
}
IImport interface.
func NewImportClient ¶
type ImportFromFileRequest ¶
type ImportFromFileRequest struct {
// This: ORPCTHIS structure that is used to send ORPC extension data to the server.
This *dcom.ORPCThis `idl:"name:This" json:"this"`
// pwszModuleDestination: Either a path in UNC to a directory that is to be used as
// the installation target location for modules and other files, or NULL to indicate
// that a directory is to be selected by the server.
ModuleDestination string `idl:"name:pwszModuleDestination;string;pointer:unique" json:"module_destination"`
// pwszInstallerPackage: A path in UNC to a file that the server will recognize as an
// installer package file.
InstallerPackage string `idl:"name:pwszInstallerPackage;string" json:"installer_package"`
// pwszUser: Either a user account name to be used as the RunAsUser property (see section
// 3.1.1.3.6) for the newly created conglomerations, or NULL to specify that the RunAsUser
// property for each conglomeration represented in the installer package file is to
// be used.
User string `idl:"name:pwszUser;string;pointer:unique" json:"user"`
// pwszPassword: Either a password to be used as the Password property (see section
// 3.1.1.3.3) for the newly created conglomerations, or NULL to specify that the Password
// property is to be set to NULL.
Password string `idl:"name:pwszPassword;string;pointer:unique" json:"password"`
// pwszRemoteServerName: Either a remote server name to be used as the ServerName
// property (see section 3.1.1.3.6) for the newly created conglomerations if the conglomerations
// represented in the installer package file are proxy conglomerations; that is, if
// they have the IsProxyApp property (see section 3.1.1.3.27) set to TRUE (0x00000001)),
// or NULL for nonproxy conglomerations.
RemoteServerName string `idl:"name:pwszRemoteServerName;string;pointer:unique" json:"remote_server_name"`
// dwFlags: MUST be a combination of zero or more of the following flags.
//
// +------------------------------+----------------------------------------------------------------------------------+
// | | |
// | FLAG | MEANING |
// | | |
// +------------------------------+----------------------------------------------------------------------------------+
// +------------------------------+----------------------------------------------------------------------------------+
// | fIMPORT_OVERWRITE 0x00000001 | The server is requested to overwrite existing files when installing modules. |
// +------------------------------+----------------------------------------------------------------------------------+
// | fIMPORT_WITHUSERS 0x00000010 | The server is requested to create the role members represented in the installer |
// | | package file. |
// +------------------------------+----------------------------------------------------------------------------------+
Flags uint32 `idl:"name:dwFlags" json:"flags"`
}
ImportFromFileRequest structure represents the ImportFromFile operation request
func (*ImportFromFileRequest) MarshalNDR ¶
func (*ImportFromFileRequest) UnmarshalNDR ¶
type ImportFromFileResponse ¶
type ImportFromFileResponse struct {
// That: ORPCTHAT structure that is used to return ORPC extension data to the client.
That *dcom.ORPCThat `idl:"name:That" json:"that"`
// pcModules: A pointer to a variable that, upon successful completion, MUST be set
// to the number of modules installed from the installer package file.
ModulesCount uint32 `idl:"name:pcModules" json:"modules_count"`
// ppModuleFlags: A pointer to a variable that upon successful completion, MUST be
// set to an array of fModuleStatus (section 2.2.3) values representing the detailed
// results of registration for the modules in ppModules, in the same order.
ModuleFlags []uint32 `idl:"name:ppModuleFlags;size_is:(, pcModules)" json:"module_flags"`
// ppModules: A pointer to a variable that, upon successful completion, MUST be set
// to an array of strings representing file names of modules installed from the installer
// package file.
Modules []string `idl:"name:ppModules;size_is:(, pcModules);string" json:"modules"`
// pcComponents: A pointer to a variable that, upon successful completion, MUST be
// set to the number of components that the server registered or attempted to register.
ComponentsCount uint32 `idl:"name:pcComponents" json:"components_count"`
// ppResultCLSIDs: A pointer to a variable that, upon successful completion, MUST
// be set to an array of GUID values, each being the CLSID of a component that the server
// registered or attempted to register.
ResultClassIDs []*dtyp.GUID `idl:"name:ppResultCLSIDs;size_is:(, pcComponents)" json:"result_class_ids"`
// ppResultNames: A pointer to a variable that, upon successful completion, SHOULD
// be set to an array of string values, each being an implementation-specific name of
// a component that the server registered or attempted to register, in the same order
// as ppResultClsids.
ResultNames []string `idl:"name:ppResultNames;size_is:(, pcComponents);string" json:"result_names"`
// ppResultFlags: A pointer to a variable that, upon successful completion, SHOULD
// be set to an array of fComponentStatus (section 2.2.4) values, each representing
// detailed results for a component that the server registered or attempted to register,
// in the same order as ppResultClsids.
ResultFlags []uint32 `idl:"name:ppResultFlags;size_is:(, pcComponents)" json:"result_flags"`
// ppResultHRs: A pointer to a variable that, upon successful completion, SHOULD be
// set to an array of LONG values, each representing an HRESULT ([MS-ERREF] section
// 2.1) for a component that the server registered or attempted to register, in the
// same order as ppResultClsids.
ResultHRs []int32 `idl:"name:ppResultHRs;size_is:(, pcComponents)" json:"result_h_rs"`
// Return: The ImportFromFile return value.
Return int32 `idl:"name:Return" json:"return"`
}
ImportFromFileResponse structure represents the ImportFromFile operation response
func (*ImportFromFileResponse) MarshalNDR ¶
func (*ImportFromFileResponse) UnmarshalNDR ¶
type ImportServer ¶
type ImportServer interface {
// IUnknown base class.
iunknown.UnknownServer
// This method is called by a client to import one or more conglomerations from an installer
// package file. Importing a conglomeration from an installer package file conceptually
// consists of installation of modules, including the registration of the components
// in those modules, and creating a conglomeration and component configurations equivalent
// to the conglomeration and the component configurations that were exported to create
// the installer package file. As a side effect, this method returns implementation-specific
// detailed results of the registration operation for informational purposes.
//
// 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.
//
// +-------------------+--------------------------+
// | RETURN | |
// | VALUE/CODE | DESCRIPTION |
// | | |
// +-------------------+--------------------------+
// +-------------------+--------------------------+
// | 0x00000000 S_OK | The call was successful. |
// +-------------------+--------------------------+
ImportFromFile(context.Context, *ImportFromFileRequest) (*ImportFromFileResponse, error)
// This method is called by a client to retrieve information about an installer package
// file.
//
// 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.
//
// +-------------------+--------------------------+
// | RETURN | |
// | VALUE/CODE | DESCRIPTION |
// | | |
// +-------------------+--------------------------+
// +-------------------+--------------------------+
// | 0x00000000 S_OK | The call was successful. |
// +-------------------+--------------------------+
QueryFile(context.Context, *QueryFileRequest) (*QueryFileResponse, error)
}
IImport server interface.
type QueryFileRequest ¶
type QueryFileRequest struct {
// This: ORPCTHIS structure that is used to send ORPC extension data to the server.
This *dcom.ORPCThis `idl:"name:This" json:"this"`
// pwszInstallerPackage: A path in UNC to a file that the server will recognize as
// an installer package file.
InstallerPackage string `idl:"name:pwszInstallerPackage;string" json:"installer_package"`
}
QueryFileRequest structure represents the QueryFile operation request
func (*QueryFileRequest) MarshalNDR ¶
func (*QueryFileRequest) UnmarshalNDR ¶
type QueryFileResponse ¶
type QueryFileResponse struct {
// That: ORPCTHAT structure that is used to return ORPC extension data to the client.
That *dcom.ORPCThat `idl:"name:That" json:"that"`
// pdwConglomerations: A pointer to a variable that, upon successful completion, MUST
// be set to the number of conglomerations represented in the installer package file.
Conglomerations uint32 `idl:"name:pdwConglomerations" json:"conglomerations"`
// ppNames: A pointer to a variable that, upon successful completion, MUST be set
// to an array of string values, each of which is the value of the Name property (see
// section 3.1.1.3.3) of a conglomeration represented in the installer package file.
Names []string `idl:"name:ppNames;size_is:(, pdwConglomerations);string" json:"names"`
// ppDescriptions: A pointer to a variable that, upon successful completion, MUST
// be set to an array of string values, each of which is the value of the Description
// property (see section 3.1.1.3.1 ) of a conglomeration represented in the installer
// package file.
Descriptions []string `idl:"name:ppDescriptions;size_is:(, pdwConglomerations);string" json:"descriptions"`
// pdwUsers: A pointer to a variable that, upon successful completion, MUST be set
// to the value TRUE (0x00000001) if the installer package file contains configuration
// for user accounts, and FALSE (0x00000000) otherwise.
Users uint32 `idl:"name:pdwUsers" json:"users"`
// pdwIsProxy: A pointer to a variable that, upon successful completion, MUST be set
// to the value TRUE (0x00000001) if the installer package file contains a proxy conglomeration,
// and FALSE (0x00000000) otherwise.
IsProxy uint32 `idl:"name:pdwIsProxy" json:"is_proxy"`
// pcModules: A pointer to a variable that, upon successful completion, MUST be set
// to the number of module contained in the installer package file.
ModulesCount uint32 `idl:"name:pcModules" json:"modules_count"`
// ppModules: A pointer to a variable that, upon successful completion, MUST be set
// to an array of strings, one for each module contained in the installer package file,
// each representing a file name for the module.
Modules []string `idl:"name:ppModules;size_is:(, pcModules);string" json:"modules"`
// Return: The QueryFile return value.
Return int32 `idl:"name:Return" json:"return"`
}
QueryFileResponse structure represents the QueryFile operation response
func (*QueryFileResponse) MarshalNDR ¶
func (*QueryFileResponse) UnmarshalNDR ¶
Source Files
Click to show internal directories.
Click to hide internal directories.