IWsTransfer Interface

WS-Transfer provides generic accessor methods for various classes.

XML namespace wxf=http://schemas.xmlsoap.org/ws/2004/09/transfer

C type for interface pointer:

Extends IUnknown

Implemented by WsMan

Methods: Get Put Delete Create

Structs: FaultTemplate Selector MaxEnvelopeSize

Methods

Get: Retrieve values.
Put: Assign value.
Delete: Zap object.
Create: Create new object.

IWsTransfer.Get Method

Retrieve values.

SCODE Get( 
    /*in,this*/ PIWSTRANSFER iThis,
    /*in*/ const _TCHAR * To,
    /*in*/ const _TCHAR * ResourceURI,
    /*in,optional*/ PSelector SelectorSet,
    /*in,optional*/ TIME OperationTimeout,
    /*out,size-is,type-is*/ void * Value,
    /*out,type-of*/ _TCHAR * pValueType,
    /*in,size-of*/ UINT ValueSize)

Returns S_OK if the method is successful, otherwise an error code.

To: The URI for request. Transferred in the wsa:To header.
ResourceURI: The URI for the resource we are getting. Transferred in the wsman:ResourceURI header.
SelectorSet: The selector for the resource instance we are getting. Transferred in the wsman:SelectorSet header.
OperationTimeout: Timeout for current operation. Transferred in the wsman:OperationTimeout header.
Value: Rather than being inherited this interface uses dynamic typing.
pValueType: Type of NewValue is returned here.
ValueSize: Size of buffer (Value).

C++

SCODE IWsTransfer::Get( 
    /*in*/ const _TCHAR * To,
    /*in*/ const _TCHAR * ResourceURI,
    /*in,optional*/ PSelector SelectorSet,
    /*in,optional*/ TIME OperationTimeout,
    /*out,size-is,type-is*/ void * Value,
    /*out,type-of*/ _TCHAR * pValueType,
    /*in,size-of*/ UINT ValueSize)

IWsTransfer.Put Method

Assign value.

SCODE Put( 
    /*in,this*/ PIWSTRANSFER iThis,
    /*in*/ const _TCHAR * To,
    /*in*/ const _TCHAR * ResourceURI,
    /*in,optional*/ PSelector SelectorSet,
    /*in,type-is,selector-is*/ const void * NewValue,
    /*in,type-of*/ const _TCHAR * NewValueType,
    /*in,selector-of*/ const UINT32* NewValueSelector,
    /*out,optional,size-is,type-is*/ void * Value,
    /*out,type-of*/ _TCHAR * pValueType,
    /*in,size-of*/ UINT ValueSize)

Returns S_OK if the method is successful, otherwise an error code.

To: The URI for request. Transferred in the wsa:To header.
ResourceURI: The URI for the resource we are putting. Transferred in the wsman:ResourceURI header.
SelectorSet: The selector for the resource instance we are putting. Transferred in the wsman:SelectorSet header.
NewValue: Dynamically typed new value.
NewValueType: Type of NewValue.
NewValueSelector: Active fields of NewValue.
Value: Return current value here.
pValueType: Type of NewValue is returned here.
ValueSize: Size of buffer (Value).

C++

SCODE IWsTransfer::Put( 
    /*in*/ const _TCHAR * To,
    /*in*/ const _TCHAR * ResourceURI,
    /*in,optional*/ PSelector SelectorSet,
    /*in,type-is,selector-is*/ const void * NewValue,
    /*in,type-of*/ const _TCHAR * NewValueType,
    /*in,selector-of*/ const UINT32* NewValueSelector,
    /*out,optional,size-is,type-is*/ void * Value,
    /*out,type-of*/ _TCHAR * pValueType,
    /*in,size-of*/ UINT ValueSize)

IWsTransfer.Delete Method

Zap object.

SCODE Delete( 
    /*in,this*/ PIWSTRANSFER iThis,
    /*in*/ const _TCHAR * To,
    /*in*/ const _TCHAR * ResourceURI,
    /*in,optional*/ PSelector SelectorSet)

Returns S_OK if the method is successful, otherwise an error code.

To: The URI for request. Transferred in the wsa:To header.
ResourceURI: The URI for the resource we are getting. Transferred in the wsman:ResourceURI header.
SelectorSet: The selector for the resource instance we are getting. Transferred in the wsman:SelectorSet header.

C++

SCODE IWsTransfer::Delete( 
    /*in*/ const _TCHAR * To,
    /*in*/ const _TCHAR * ResourceURI,
    /*in,optional*/ PSelector SelectorSet)

IWsTransfer.Create Method

Create new object.

SCODE Create( 
    /*in,this*/ PIWSTRANSFER iThis,
    /*in*/ const _TCHAR * To,
    /*in*/ const _TCHAR * ResourceURI,
    /*in,type-is*/ const void * InitialValue,
    /*in,type-of*/ const _TCHAR * ValueType,
    /*out*/ PEndpointReference_QUIET ResourceCreated)

Returns S_OK if the method is successful, otherwise an error code.

To: The URI for request. Transferred in the wsa:To header.
ResourceURI: The URI for the resource we are getting. Transferred in the wsman:ResourceURI header.
InitialValue: Dynamically typed initial value.
ValueType: Type of InitialValue.
ResourceCreated: Reference to the new object.

C++

SCODE IWsTransfer::Create( 
    /*in*/ const _TCHAR * To,
    /*in*/ const _TCHAR * ResourceURI,
    /*in,type-is*/ const void * InitialValue,
    /*in,type-of*/ const _TCHAR * ValueType,
    /*out*/ PEndpointReference_QUIET ResourceCreated)

FaultTemplate Structure

Fields

FaultMessage: C/C++ type: _TCHAR *; Serializer Type: string

Selector Structure

Fields

MaxEnvelopeSize Structure

Fields