Apêndice 1: tabela de cadeias de código de erro

As mensagens de erro de cache no Microsoft AppFabric 1.1 para Windows Server contêm uma cadeia de código de erro e uma cadeia de substatus do erro. Este apêndice fornece uma conexão entre as mensagens de erro e as constantes que os desenvolvedores podem usar para tratar esses erros.

A mensagem de erro a seguir é um exemplo do que você poderá ver em um log de aplicativo habilitado para armazenamento em cache:

ErrorCode <ERRCA0017>:SubStatus<ES0006>:There is a temporary failure. Please retry later. (One or more specified Cache servers are unavailable, which could be caused by busy network or servers. Ensure that security permission has been granted for this client account on the cluster and that the AppFabric Caching Service is allowed through the firewall on all cache hosts. Retry later.)

Embora essa mensagem de erro explique o problema, ela não informa aos desenvolvedores o tipo exato de objeto DataCacheException que está sendo gerado. Neste caso, o objeto DataCacheException tem uma propriedade ErrorCode que tem um valor RetryLater e uma propriedade SubStatus que tem um valor CacheServerUnavailable. Isso permite que o desenvolvedor use o tratamento de exceções para tomar uma ação mais específica em resposta a esse erro, como repetir a chamada. Ele também permite que o Profissional de TI encontre mais informações sobre o erro. Para este exemplo de mensagem de erro, há ajuda mais detalhada na seguinte seção deste documento: RetryLater (CacheServerUnavailable).

Dica

Para obter mais informações sobre tratamento de erros de Cache do AppFabric, consulte Tratamento de erros. Para obter orientação sobre como solucionar diversos erros comuns de armazenamento em cache, consulte Extensão do aplicativo neste documento.

A tabela a seguir conecta cadeias de código de erro com constantes de código de erro na classe DataCacheErrorCode.

Cadeia de código de erro	Constante DataCacheErrorCode
ERRCA0001	CacheItemVersionMismatch
ERRCA0002	RegistryKeyOpenFailure
ERRCA0003	InvalidArgument
ERRCA0004	UndefinedError
ERRCA0005	RegionDoesNotExist
ERRCA0006	KeyDoesNotExist
ERRCA0007	RegionAlreadyExists
ERRCA0008	KeyAlreadyExists
ERRCA0009	NamedCacheDoesNotExist
ERRCA0010	MaxNamedCacheCountExceeded
ERRCA0011	ObjectLocked
ERRCA0012	ObjectNotLocked
ERRCA0013	InvalidCacheLockHandle
ERRCA0014	InvalidEnumerator
ERRCA0015	NotificationInvalidationNotSupported
ERRCA0016	ConnectionTerminated
ERRCA0017	RetryLater
ERRCA0018	Timeout
ERRCA0019	ClientServerVersionMismatch
ERRCA0020	SerializationException
ERRCA0021	ServerNull
ERRCAdmin001	CacheAdminHostsRunning
ERRCAdmin002	CacheAdminRequestTimeoutResultUnknown
ERRCAdmin003	CacheAdminTimeout
ERRCAdmin004	CacheAdminNullArgs
ERRCAdmin005	CacheAdminUnknownError
ERRCAdmin006	CacheAdminQuorumNotUp
ERRCAdmin007	CacheAdminStoreAccessFailure
ERRCAdmin008	CacheAdminHostsNotRunning
ERRCAdmin009	CacheAdminCacheNotPresent
ERRCAdmin010	CacheAdminHostNotPresent
ERRCAdmin011	CacheAdminCacheAlreadyPresent
ERRCAdmin012	CacheAdminRegionNotPresent
ERRCAdmin013	CacheAdminNoQuorumIfHostStopped
ERRCAdmin014	CacheAdminNoSeedNodes
ERRCAdmin015	CacheAdminHostRunning
ERRCAdmin016	CacheAdminHostNotRunning
ERRCAdmin017	CacheAdminConfigDeleteHostError
ERRCAdmin018	CacheAdminConfigAddHostError
ERRCAdmin019	CacheAdminDefaultCacheCreateFailure
ERRCAdmin020	CacheAdminDeleteInProgress
ERRCAdmin021	CacheAdminCacheCreationInconsistencyFailure
ERRCAdmin022	CacheAdminHostNameResolveFailure
ERRCAdmin023	CacheAdminNoHosts
ERRCAdmin024	CacheAdminClusterRefreshFailed
ERRCAdmin025	CacheAdminClusterTimeout
ERRCAdmin026	CacheAdminRemoteRegistryAccessFailed
ERRCAdmin027	CacheAdminWindowsAccountInvalid
ERRCAdmin028	CacheAdminWindowsAccountAlreadyPresent
ERRCAdmin029	CacheAdminWindowsAccountNotPresent
ERRCAdmin030	CacheAdminGrantClientAccountErrorFormat
ERRCAdmin031	CacheAdminRevokeClientAccountErrorFormat
ERRCAdmin032	CacheAdminInvalidOperation
ERRCAdmin033	CacheAdminClusterNotReady
ERRCAdmin034	CacheAdminHostRefreshFailed
ERRPS001	CacheAdminClusterSettingsReadError
ERRPS002	CacheAdminInvalidClusterSettings
ERRPS003	CacheAdminMaxCachesCreated
ERRPS004	CacheAdminPortsDuplicated
ERRPS005	CacheAdminClusterDown
ERRPS006	CacheAdminStatsIncorrect
ERRPS007	CacheAdminInvalidSecuritySettings
ERRPS008	CacheAdminInstallPathReadError
ERRPS009	CacheAdminCacheNotCreated
ERRPS010	CacheAdminCacheNotRemoved

A tabela a seguir conecta cadeias de substatus do erro com constantes de substatus do erro na classe DataCacheErrorSubStatus.

Cadeia de substatus do erro	Constante DataCacheErrorSubStatus
ES0001	None
ES0002	NotPrimary
ES0003	NoWriteQuorum
ES0004	ReplicationQueueFull
ES0005	KeyLatched
ES0006	CacheServerUnavailable
ES0007	Throttled

Consulte também

Conceitos

Guia de Implantação e Gerenciamento de Cache do AppFabric 1.1

  2012-03-05