Skip to content

Latest commit

 

History

History
152 lines (98 loc) · 6.3 KB

File metadata and controls

152 lines (98 loc) · 6.3 KB
title SyncLockWithStatusT Class | Microsoft Docs
ms.custom
ms.date 10/03/2018
ms.technology
cpp-windows
ms.topic reference
f1_keywords
corewrappers/Microsoft::WRL::Wrappers::Details::SyncLockWithStatusT
corewrappers/Microsoft::WRL::Wrappers::Details::SyncLockWithStatusT::GetStatus
corewrappers/Microsoft::WRL::Wrappers::Details::SyncLockWithStatusT::IsLocked
corewrappers/Microsoft::WRL::Wrappers::Details::SyncLockWithStatusT::status_
corewrappers/Microsoft::WRL::Wrappers::Details::SyncLockWithStatusT::SyncLockWithStatusT
dev_langs
C++
helpviewer_keywords
Microsoft::WRL::Wrappers::Details::SyncLockWithStatusT class
Microsoft::WRL::Wrappers::Details::SyncLockWithStatusT::GetStatus method
Microsoft::WRL::Wrappers::Details::SyncLockWithStatusT::IsLocked method
Microsoft::WRL::Wrappers::Details::SyncLockWithStatusT::status_ data member
Microsoft::WRL::Wrappers::Details::SyncLockWithStatusT::SyncLockWithStatusT, constructor
ms.assetid 4832fd93-0ac8-4168-9404-b43fefea7476
author mikeblome
ms.author mblome
ms.workload
cplusplus
uwp

SyncLockWithStatusT Class

Supports the WRL infrastructure and is not intended to be used directly from your code.

Syntax

template <typename SyncTraits>
class SyncLockWithStatusT : public SyncLockT<SyncTraits>;

Parameters

SyncTraits
A type that can take exclusive or shared ownership of a resource.

Remarks

Represents a type that can take exclusive or shared ownership of a resource.

The SyncLockWithStatusT class is used to implement the Mutex and Semaphore classes.

Members

Public Constructors

Name Description
SyncLockWithStatusT::SyncLockWithStatusT Initializes a new instance of the SyncLockWithStatusT class.

Protected Constructors

Name Description
SyncLockWithStatusT::SyncLockWithStatusT Initializes a new instance of the SyncLockWithStatusT class.

Public Methods

Name Description
SyncLockWithStatusT::GetStatus Retrieves the wait status of the current SyncLockWithStatusT object.
SyncLockWithStatusT::IsLocked Indicates whether the current SyncLockWithStatusT object owns a resource; that is, the SyncLockWithStatusT object is locked.

Protected Data Members

Name Description
SyncLockWithStatusT::status_ Holds the result of the underlying wait operation after a lock operation on an object based on the current SyncLockWithStatusT object.

Inheritance Hierarchy

SyncLockT

SyncLockWithStatusT

Requirements

Header: corewrappers.h

Namespace: Microsoft::WRL::Wrappers::Details

SyncLockWithStatusT::GetStatus

Supports the WRL infrastructure and is not intended to be used directly from your code.

DWORD GetStatus() const;

Return Value

The result of a wait operation on the object that is based on the SyncLockWithStatusT class, such as a Mutex or Semaphore. Zero (0) indicates the wait operation returned the signaled state; otherwise, another state occurred, such as time-out value elapsed.

Remarks

Retrieves the wait status of the current SyncLockWithStatusT object.

The GetStatus() function retrieves the value of the underlying status_ data member. When an object based on the SyncLockWithStatusT class performs a lock operation, the object first waits for the object to become available. The result of that wait operation is stored in the status_ data member. The possible values of the status_ data member are the return values of the wait operation. For more information, see the return values of the WaitForSingleObjectEx() function in the MSDN Library.

SyncLockWithStatusT::IsLocked

Supports the WRL infrastructure and is not intended to be used directly from your code.

bool IsLocked() const;

Remarks

Indicates whether the current SyncLockWithStatusT object owns a resource; that is, the SyncLockWithStatusT object is locked.

Return Value

true if the SyncLockWithStatusT object is locked; otherwise, false.

SyncLockWithStatusT::status_

Supports the WRL infrastructure and is not intended to be used directly from your code.

DWORD status_;

Remarks

Holds the result of the underlying wait operation after a lock operation on an object based on the current SyncLockWithStatusT object.

SyncLockWithStatusT::SyncLockWithStatusT

Supports the WRL infrastructure and is not intended to be used directly from your code.

SyncLockWithStatusT(
   _Inout_ SyncLockWithStatusT&& other
);

explicit SyncLockWithStatusT(
   typename SyncTraits::Type sync,
   DWORD status
);

Parameters

other
An rvalue-reference to another SyncLockWithStatusT object.

sync
A reference to another SyncLockWithStatusT object.

status
The value of the status_ data member of the other parameter or the sync parameter.

Remarks

Initializes a new instance of the SyncLockWithStatusT class.

The first constructor initializes the current SyncLockWithStatusT object from another SyncLockWithStatusT specified by parameter other, and then invalidates the other SyncLockWithStatusT object. The second constructor is protected, and initializes the current SyncLockWithStatusT object to an invalid state.