Struct sspi::builders::InitializeSecurityContext

pub struct InitializeSecurityContext<'a, Inner, CredsHandle, CredsHandleSet, ContextRequirementsSet, TargetDataRepresentationSet, OutputSet> where
    Inner: SspiImpl,
    CredsHandleSet: ToAssign,
    ContextRequirementsSet: ToAssign,
    TargetDataRepresentationSet: ToAssign,
    OutputSet: ToAssign,  {
    pub credentials_handle: Option<&'a mut CredsHandle>,
    pub context_requirements: ClientRequestFlags,
    pub target_data_representation: DataRepresentation,
    pub output: &'a mut [SecurityBuffer],
    pub target_name: Option<&'a str>,
    pub input: Option<&'a mut [SecurityBuffer]>,
    // some fields omitted
}

A builder to execute one of the SSPI functions. Returned by the initialize_security_context method.

Requirements for execution

These methods are required to be called before calling the execute method

• with_credentials_handle
• with_context_requirements
• with_target_data_representation
• with_output

Fields

credentials_handle: Option<&'a mut CredsHandle>

context_requirements: ClientRequestFlags

target_data_representation: DataRepresentation

output: &'a mut [SecurityBuffer]

target_name: Option<&'a str>

input: Option<&'a mut [SecurityBuffer]>

Implementations

impl<'a, Inner: SspiImpl, CredsHandle, CredsHandleSet: ToAssign, ContextRequirementsSet: ToAssign, TargetDataRepresentationSet: ToAssign, OutputSet: ToAssign> InitializeSecurityContext<'a, Inner, CredsHandle, CredsHandleSet, ContextRequirementsSet, TargetDataRepresentationSet, OutputSet>

pub fn with_credentials_handle(
    self,
    credentials_handle: &'a mut CredsHandle
) -> InitializeSecurityContext<'a, Inner, CredsHandle, WithCredentialsHandle, ContextRequirementsSet, TargetDataRepresentationSet, OutputSet>

Specifies a handle to the credentials returned by acquire_credentials_handle. This handle is used to build the security context. The builder requires at least CredentialUse::Outbound credentials.

pub fn with_context_requirements(
    self,
    context_requirements: ClientRequestFlags
) -> InitializeSecurityContext<'a, Inner, CredsHandle, CredsHandleSet, WithContextRequirements, TargetDataRepresentationSet, OutputSet>

Specifies bit flags that indicate requests for the context. Not all packages can support all requirements.

pub fn with_target_data_representation(
    self,
    target_data_representation: DataRepresentation
) -> InitializeSecurityContext<'a, Inner, CredsHandle, CredsHandleSet, ContextRequirementsSet, WithTargetDataRepresentation, OutputSet>

Specifies the data representation, such as byte ordering, on the target.

pub fn with_output(
    self,
    output: &'a mut [SecurityBuffer]
) -> InitializeSecurityContext<'a, Inner, CredsHandle, CredsHandleSet, ContextRequirementsSet, TargetDataRepresentationSet, WithOutput>

Specifies a mutable reference to a buffer with SecurityBuffer that receives the output data.

pub fn with_target_name(self, target_name: &'a str) -> Self

pub fn with_input(self, input: &'a mut [SecurityBuffer]) -> Self

Specifies a mutable reference to a buffer with SecurityBuffer structures. Don't call this method on during the first execution of the builder. On the second execution, this parameter is a reference to the partially formed context returned during the first call.

impl<'a, Inner: SspiImpl<CredentialsHandle = CredsHandle>, CredsHandle> InitializeSecurityContext<'a, I, C, WithCredentialsHandle, WithContextRequirements, WithTargetDataRepresentation, WithOutput>

pub fn execute(self) -> Result<InitializeSecurityContextResult>

Executes the SSPI function that the builder represents.